Exporter (0) Imprimer
Développer tout

Valeurs xPath dans Windows Azure

Mis à jour: novembre 2013

À compter du Kit de développement logiciel 1.5 de Windows Azure, vous pouvez utiliser l'élément xPath dans un fichier de définition de service d'un rôle de travail ou d'un rôle Web pour récupérer les valeurs de configuration du runtime. Le tableau suivant présente les valeurs prises en charge par xPath et leur équivalent fonctionnel dans l'API d'exécution du service.

 

Objectif xPath Description

Détermine si le déploiement s'exécute dans l'émulateur de calcul ou sur Windows Azure.

xpath="/RoleEnvironment/Deployment/@emulated"

L'utilisation du chemin d'accès de l'emplacement @emulated pour le déploiement est fonctionnellement équivalente à l'instruction suivante :

var x = RoleEnvironment.IsEmulated;

Pour plus d'informations, consultez la classe RoleEnvironment.

Récupère l'ID de déploiement pour l'instance.

xpath="/RoleEnvironment/Deployment/@id"

L'utilisation du chemin d'accès de l'emplacement @id pour le déploiement est fonctionnellement équivalente à l'instruction suivante :

var deploymentId = RoleEnvironment.DeploymentId;

Pour plus d'informations, consultez la classe RoleEnvironment.

Récupère l'ID du rôle actuel pour l'instance.

xpath="/RoleEnvironment/CurrentInstance/@id"

L'utilisation du chemin d'accès de l'emplacement @id pour l'instance actuelle est fonctionnellement équivalente à l'instruction suivante :

var id = RoleEnvironment.CurrentRoleInstance.Id;

Pour plus d'informations, consultez la classe RoleEnvironment.

Récupère le domaine de mise à jour de l'instance.

xpath="/RoleEnvironment/CurrentInstance/@updateDomain"

L'utilisation du chemin d'accès de l'emplacement @updateDomain pour l'instance actuelle est fonctionnellement équivalente à l'instruction suivante :

var ud = RoleEnvironment.CurrentRoleInstance.UpdateDomain;

Pour plus d'informations, consultez la classe RoleEnvironment.

Récupère le domaine par défaut de l'instance.

xpath="/RoleEnvironment/CurrentInstance/@faultDomain"

L'utilisation du chemin d'accès de l'emplacement @faultDomain pour l'instance actuelle est fonctionnellement équivalente à l'instruction suivante :

var fd = RoleEnvironment.CurrentRoleInstance.FaultDomain;

Pour plus d'informations, consultez la classe RoleEnvironment.

Récupère le nom de rôle des instances.

xpath="/RoleEnvironment/CurrentInstance/@roleName"

L'utilisation du chemin d'accès de l'emplacement @roleName pour l'instance actuelle est fonctionnellement équivalente à l'instruction suivante :

var rname = RoleEnvironment.CurrentRoleInstance.Role.Name;

Pour plus d'informations, consultez la classe RoleEnvironment.

Récupère la valeur du paramètre de configuration spécifié.

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

L'utilisation du chemin d'accès de l'emplacement @value pour l'instance actuelle est fonctionnellement équivalente à l'instruction suivante :

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

Pour plus d'informations, consultez la classe RoleEnvironment.

Récupère le chemin d'accès du stockage local pour l'instance.

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

L'utilisation du chemin d'accès de l'emplacement @path pour l'instance actuelle est fonctionnellement équivalente à l'instruction suivante :

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

Pour plus d'informations, consultez la classe RoleEnvironment.

Récupère la taille du stockage local pour l'instance.

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

L'utilisation du chemin d'accès de l'emplacement @sizeInMB pour l'instance actuelle est fonctionnellement équivalente à l'instruction suivante :

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

Pour plus d'informations, consultez la classe RoleEnvironment.

Récupère le protocole de point de terminaison pour l'instance.

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

L'utilisation du chemin d'accès de l'emplacement @protocol pour l'instance actuelle est fonctionnellement équivalente à l'instruction suivante :

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

Pour plus d'informations, consultez la classe RoleEnvironment.

Récupère le port de point de terminaison pour l'instance.

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

L'utilisation du chemin d'accès de l'emplacement @port pour l'instance actuelle est fonctionnellement équivalente à l'instruction suivante :

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

Pour plus d'informations, consultez la classe RoleEnvironment.

Récupère l'adresse IP de point de terminaison pour l'instance.

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

L'utilisation du chemin d'accès de l'emplacement @address pour l'instance actuelle est fonctionnellement équivalente à l'instruction suivante :

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

Pour plus d'informations, consultez la classe RoleEnvironment.

Le segment de définition de service suivant montre l'utilisation de l'élément 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>

Voir aussi

Afficher:
© 2014 Microsoft