MessageQueue.MachineName Propriété

  • Référence

Définition

Espace de noms:
System.Messaging
Assembly:
System.Messaging.dll

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, set
Public Property MachineName As String

Valeur de propriété

String

Nom de l'ordinateur où se trouve la file d'attente. La valeur par défaut de Message Queuing est ".", ce qui correspond à l'ordinateur local.

Attributs
BrowsableAttribute MessagingDescriptionAttribute

Exceptions

ArgumentException

MachineName a la valeur null. - ou -

Nom de l'ordinateur n'est pas valide. La syntaxe utilisée est sans doute incorrecte.

MessageQueueException

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

MachineName est 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 de 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 du journal 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 transactionnelles de l’ordinateur MachineName\XactDeadletter$

Utilisez « . » pour l’ordinateur local lors de la spécification de 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 en Path termes de , l’application lève une exception en mode hors connexion, car le contrôleur de domaine est requis pour la MachineNametraduction de chemin d’accès. Par conséquent, vous devez utiliser pour FormatName la Path syntaxe lorsque vous travaillez hors connexion.

Les MachineNamepropriétés , Pathet QueueName sont liées. La modification de la MachineName propriété entraîne la modification de la Path propriété. Il est créé à partir du nouveau MachineName et du QueueName. La modification de ( Path par exemple, pour utiliser la syntaxe de nom de format) réinitialise les MachineName propriétés et QueueName pour faire référence à la nouvelle file d’attente. Si la QueueName propriété est vide, est Path défini 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

S’applique à

Voir aussi