匯出 (0) 列印
全部展開

Windows Azure 中的 xPath 值

更新日期: 2014年10月

從 Azure SDK 1.5 開始,您可以在 Web 角色或背景工作角色服務定義檔中使用 xPath 元素擷取執行階段組態值。下表舉出支援的 xPath 值及其作用相當的服務執行階段應用程式開發介面。

 

xPath 用途 描述

判斷部署是在計算模擬器執行還是在 Azure 執行。

xpath="/RoleEnvironment/Deployment/@emulated"

使用部署的 @emulated 位置路徑,其作用相當於以下陳述式:

var x = RoleEnvironment.IsEmulated;

如需詳細資訊,請參閱<RoleEnvironment 類別>。

擷取執行個體的部署識別碼。

xpath="/RoleEnvironment/Deployment/@id"

使用部署的 @id 位置路徑,其作用相當於以下陳述式:

var deploymentId = RoleEnvironment.DeploymentId;

如需詳細資訊,請參閱<RoleEnvironment 類別>。

擷取執行個體的目前角色 ID。

xpath="/RoleEnvironment/CurrentInstance/@id"

使用目前執行個體的 @id 位置路徑,其作用相當於以下陳述式:

var id = RoleEnvironment.CurrentRoleInstance.Id;

如需詳細資訊,請參閱<RoleEnvironment 類別>。

擷取執行個體的更新網域。

xpath="/RoleEnvironment/CurrentInstance/@updateDomain"

使用目前執行個體的 @updateDomain 位置路徑,其作用相當於以下陳述式:

var ud = RoleEnvironment.CurrentRoleInstance.UpdateDomain;

如需詳細資訊,請參閱<RoleEnvironment 類別>。

擷取執行個體的錯誤網域。

xpath="/RoleEnvironment/CurrentInstance/@faultDomain"

使用目前執行個體的 @faultDomain 位置路徑,其作用相當於以下陳述式:

var fd = RoleEnvironment.CurrentRoleInstance.FaultDomain;

如需詳細資訊,請參閱<RoleEnvironment 類別>。

擷取執行個體的角色名稱。

xpath="/RoleEnvironment/CurrentInstance/@roleName"

使用目前執行個體的 @roleName 位置路徑,其作用相當於以下陳述式:

var rname = RoleEnvironment.CurrentRoleInstance.Role.Name;

如需詳細資訊,請參閱<RoleEnvironment 類別>。

擷取指定之組態設定的值。

xpath="/RoleEnvironment/CurrentInstance/ConfigurationSettings/ConfigurationSetting[@name='Setting1']/@value"

使用目前執行個體的 @value 位置路徑,其作用相當於以下陳述式:

var setting = RoleEnvironment.GetConfigurationSettingValue("Setting1");

如需詳細資訊,請參閱<RoleEnvironment 類別>。

擷取執行個體的本機儲存體路徑。

xpath="/RoleEnvironment/CurrentInstance/LocalResources/LocalResource[@name='LocalStore1']/@path"

使用目前執行個體的 @path 位置路徑,其作用相當於以下陳述式:

var localResourcePath = RoleEnvironment.GetLocalResource("LocalStore1").RootPath;

如需詳細資訊,請參閱<RoleEnvironment 類別>。

擷取執行個體的本機儲存體大小。

xpath="/RoleEnvironment/CurrentInstance/LocalResources/LocalResource[@name='LocalStore1']/@sizeInMB"

使用目前執行個體的 @sizeInMB 位置路徑,其作用相當於以下陳述式:

var localResourceSizeInMB = RoleEnvironment.GetLocalResource("LocalStore1").MaximumSizeInMegabytes;

如需詳細資訊,請參閱<RoleEnvironment 類別>。

擷取執行個體的端點通訊協定。

xpath="/RoleEnvironment/CurrentInstance/Endpoints/Endpoint[@name='Endpoint1']/@protocol"

使用目前執行個體的 @protocol 位置路徑,其作用相當於以下陳述式:

var prot = RoleEnvironment.CurrentRoleInstance.InstanceEndpoints["Endpoint1"].Protocol;

如需詳細資訊,請參閱<RoleEnvironment 類別>。

擷取執行個體的端點連接埠。

xpath="/RoleEnvironment/CurrentInstance/Endpoints/Endpoint[@name='Endpoint1']/@port"

使用目前執行個體的 @port 位置路徑,其作用相當於以下陳述式:

var port = RoleEnvironment.CurrentRoleInstance.InstanceEndpoints["Endpoint1"].IPEndpoint.Port;

如需詳細資訊,請參閱<RoleEnvironment 類別>。

擷取執行個體的端點 IP 位址。

xpath="/RoleEnvironment/CurrentInstance/Endpoints/Endpoint[@name='Endpoint1']/@address"

使用目前執行個體的 @address 位置路徑,其作用相當於以下陳述式:

var address = RoleEnvironment.CurrentRoleInstance.InstanceEndpoints["Endpoint1"].IPEndpoint.Address;

如需詳細資訊,請參閱<RoleEnvironment 類別>。

下列服務定義區段示範 xPath 元素的用法:

 
<WorkerRole name="Role1">
    <ConfigurationSettings>
      <Setting name="Setting1" />
    </ConfigurationSettings>
    <LocalResources>
      <LocalStorage name="LocalStore1" sizeInMB="1024"/>
    </LocalResources>
    <Endpoints>
      <InternalEndpoint name="Endpoint1" protocol="tcp" />
    </Endpoints>
    <Startup>
      <Task commandLine="example.cmd inputParm">
        <Environment>
          <Variable name="TestConstant" value="Constant"/>
          <Variable name="TestEmptyValue" value=""/>
          <Variable name="TestIsEmulated">
            <RoleInstanceValue xpath="/RoleEnvironment/Deployment/@emulated"/>
          </Variable>
                        …
        </Environment>
      </Task>
    </Startup>
    <Runtime>
      <Environment>
        <Variable name="TestConstant" value="Constant"/>
        <Variable name="TestEmptyValue" value=""/>
        <Variable name="TestIsEmulated">
          <RoleInstanceValue xpath="/RoleEnvironment/Deployment/@emulated"/>
        </Variable>
                   …
      </Environment>
    </Runtime>
    ...
</WorkerRole>

另請參閱

顯示:
© 2015 Microsoft