MessageQueue.MachineName Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Obtient ou définit le nom de l’ordinateur où se trouve la file d’attente Message Queuing.
public:
property System::String ^ MachineName { System::String ^ get(); void set(System::String ^ value); };[System.ComponentModel.Browsable(false)]
[System.Messaging.MessagingDescription("MQ_MachineName")]
public string MachineName { get; set; }[<System.ComponentModel.Browsable(false)>]
[<System.Messaging.MessagingDescription("MQ_MachineName")>]
member this.MachineName : string with get, setPublic Property MachineName As StringValeur de propriété
Nom de l’ordinateur où se trouve la file d’attente. La valeur par défaut de Message Queuing est « ».
- Attributs
Exceptions
MachineName a la valeur null.
- ou -
Le nom de l’ordinateur n’est pas valide, peut-être parce que la syntaxe est incorrecte.
Une erreur s’est produite lors de l’accès à une méthode Message Queuing.
Exemples
L’exemple de code suivant obtient et définit la valeur de la propriété d’une file d’attente de MachineName messages.
// Set the queue's MachineName property value to the name of the local
// computer.
queue.MachineName = ".";
// Display the new value of the queue's MachineName property.
Console.WriteLine("MessageQueue.MachineName: {0}", queue.MachineName);
Remarques
Il MachineName s’agit d’un composant intégral de la syntaxe de nom convivial de la file d’attente Path. Le tableau suivant montre la syntaxe que vous devez utiliser pour une file d’attente d’un type spécifié lorsque vous souhaitez identifier le chemin d’accès à la file d’attente à l’aide de son nom convivial.
| Type de file d'attente | Syntaxe |
|---|---|
| File d’attente publique | MachineName\QueueName |
| File d’attente privée | MachineName\Private$\QueueName |
| File d’attente de journaux | MachineName\QueueName\Journal$ |
| File d’attente du journal de l’ordinateur | MachineName\Journal$ |
| File d’attente de lettres mortes de l’ordinateur | MachineName\Deadletter$ |
| File d’attente de lettres mortes de l’ordinateur | MachineName\XactDeadletter$ |
Utilisez « . » pour l’ordinateur local lors de la spécification du MachineName. Seul le nom de l’ordinateur est reconnu pour cette propriété, par exemple Server0. La MachineName propriété ne prend pas en charge le format d’adresse IP.
Si vous définissez les Path termes de l’application MachineName, l’application lève une exception lors de l’utilisation hors connexion, car le contrôleur de domaine est requis pour la traduction de chemins d’accès. Par conséquent, vous devez utiliser la FormatName syntaxe lors de l’utilisation Path hors connexion.
Les MachineNamepropriétés et QueueName les Pathpropriétés sont associées. La modification de la MachineName propriété entraîne la modification de la Path propriété. Il est construit à partir du nouveau MachineName et du QueueName. La modification de la Path syntaxe de nom de format (par exemple) réinitialise les propriétés et QueueName les MachineName propriétés pour faire référence à la nouvelle file d’attente. Si la QueueName propriété est vide, elle Path est définie sur la file d’attente journal de l’ordinateur que vous spécifiez.
Le tableau suivant indique si cette propriété est disponible dans différents modes de groupe de travail.
| Mode groupe de travail | Disponible |
|---|---|
| Ordinateur local | Oui |
| Ordinateur local et nom de format direct | Oui |
| Ordinateur distant | Oui |
| Ordinateur distant et nom de format direct | Non |
