ILocationService 介面

服務負責提供與 Team Foundation Server 的連接以及可供此其他服務的位置。

命名空間：  Microsoft.TeamFoundation.Framework.Client
組件：  Microsoft.TeamFoundation.Client (在 Microsoft.TeamFoundation.Client.dll 中)

語法

'宣告
Public Interface ILocationService

public interface ILocationService

ILocationService 類型會公開下列成員。

屬性

	名稱	描述
	ClientAccessMapping	目前連接的 AccessMapping 與伺服器。請注意，則目前 ClientAccessMapping 不是 ConfiguredAccessMappings 成員存取點，如果這個用戶端使用連接到伺服器未設定此。這永遠不會是 null。
	ConfiguredAccessMappings	這個位置服務知道的任何 AccessMappings。由於特定位置服務可以繼承其父代的 AccessMappings 這些 AccessMappings 在這個位置服務或其父代可能存在。
	DefaultAccessMapping	這個位置服務的預設 AccessMapping。這永遠不會是 null。

回頁首

方法

	名稱	描述
	ConfigureAccessMapping	設定 AccessMapping 以提供的 Moniker 所提供的顯示名稱和存取點。這個函式也允許這 AccessMapping 進行預設 AccessMapping。
	FindServiceDefinition	尋找具有指定服務類型和服務識別項的 ServiceDefinition。如果找不到 ServiceDefinition 不存在，會傳回 null。
	FindServiceDefinitions	尋找所有的 ServiceDefinitions 與中指定之服務型別的服務。如果型別 ServiceDefinitions 存在，則傳回空列舉型別不會傳回。
	FindServiceDefinitionsByToolType	尋找所有的 ServiceDefinitions 與指定的工具型別的服務。如果服務為這個工具型別不存在，則傳回空列舉型別會傳回。
	GetAccessMapping	取得 AccessMapping 和指定的 Moniker。如果 AccessMapping 和提供的 Moniker 不存在，則傳回 Null。
	LocationForAccessMapping(ServiceDefinition, AccessMapping)	傳回 ServiceDefinition 位置提供的 AccessMapping 的。如果這個 ServiceDefinition 是完整的，而這 AccessMapping 空白則 LocationMapping 存在不會傳回。
	LocationForAccessMapping(String, Guid, AccessMapping)	傳回具有所提供之 AccessMapping 的指定服務型別和服務識別項的 ServiceDefinition 的位置。如果這個 ServiceDefinition 是完整的，而這 AccessMapping 空白則 LocationMapping 存在不會傳回。
	LocationForCurrentConnection(ServiceDefinition)	傳回應該使用以目前連接的 ServiceDefintion 的位置。這個方法永遠不會傳回 null 或空白。如果成功則傳回提供的 ServiceDefinition 的設為目標的位置。當判斷時傳回的什麼位置為 ServiceDefinition 和目前連接下列規則將套用:1.嘗試尋找 ClientAccessMapping 的位置。2.嘗試尋找 DefaultAccessMapping 的位置。3.使用第一個位置。LocationMappings 清單。
	LocationForCurrentConnection(String, Guid)	傳回 ServiceDefintion 的位置與 ServiceType，應該使用的 ServiceIdentifier 根據目前連接。如果 ServiceDefinition 和 ServiceType 和 ServiceIdentifier 則不存在則會傳回。如果和 ServiceType 和 ServiceIdentifier 所以找不到 ServiceDefinition 得位置會傳回，如果 ServiceDefinition 的語式正確 (否則會擲回例外狀況)。當判斷時傳回的什麼位置為 ServiceDefinition 和目前連接下列規則將套用:1.嘗試尋找 ClientAccessMapping 的位置。2.嘗試尋找 DefaultAccessMapping 的位置。3.使用第一個位置。LocationMappings 清單。
	RemoveAccessMapping	取消對應到 ServiceDefinitions AccessMapping 和內的任何位置。
	RemoveServiceDefinition(ServiceDefinition)	從位置服務移除指定的 ServiceDefinition。
	RemoveServiceDefinition(String, Guid)	移除 ServiceDefinition 與所指定的服務類型和服務識別項位置 serivce。
	RemoveServiceDefinitions	從位置服務移除指定的 ServiceDefinitions。
	SaveServiceDefinition	儲存在位置服務中提供的 ServiceDefinition。這項作業會將 ServiceDefinition 物件的識別項屬性一個是否尚未指派。在 LocationMappings 屬性參考的所有 AccessMappings 必須已經設定位置服務。
	SaveServiceDefinitions	儲存在位置服務中提供的 ServiceDefinitions。這項作業會將 ServiceDefinition 物件的識別項屬性一個是否尚未指派。在 LocationMappings 屬性參考的所有 AccessMappings 必須已經設定位置服務。
	SetDefaultAccessMapping	設定預設 AccessMapping 傳遞的 AccessMapping。

回頁首

請參閱

參考

Microsoft.TeamFoundation.Framework.Client 命名空間