MessageQueue.MachineName Propriété

Référence

Définition

Espace de noms:: System.Messaging

Assembly:: System.Messaging.dll

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, 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 à

Partager via