MessageQueue.MachineName Свойство

Определение

Пространство имен:

System.Messaging

Сборка:

System.Messaging.dll

Получает или задает имя компьютера, на котором расположена очередь 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

Значение свойства

String

Имя компьютера, на котором расположена очередь. По умолчанию службой Message Queuing используется значение ".", т. е. локальный компьютер.

Атрибуты

BrowsableAttribute MessagingDescriptionAttribute

Исключения

ArgumentException

Значение параметра MachineName — null. -или-

Недопустимое имя компьютера. Причиной может быть неверный синтаксис.

MessageQueueException

При обращении к методу службы очереди сообщений возникла ошибка.

Примеры

В следующем примере кода возвращается и задается значение свойства очереди MachineName сообщений.

// 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);

Комментарии

MachineName является целочисленным компонентом понятного синтаксиса имен очереди Path. В следующей таблице показан синтаксис, который следует использовать для очереди указанного типа, если требуется определить путь очереди, используя понятное имя.

Тип очереди	Синтаксис
Общедоступная очередь	MachineName\QueueName
Частная очередь	MachineName\Private$\QueueName
очередь Журнал	MachineName\QueueName\Journal$
Очередь журнала компьютера	MachineName\Journal$
Очередь недоставленных сообщений на компьютере	MachineName\Deadletter$
Очередь недоставленных сообщений на компьютере	MachineName\XactDeadletter$

Используйте "." для локального компьютера при указании MachineName. Для этого свойства распознается только имя компьютера, например Server0. Свойство MachineName не поддерживает формат IP-адреса.

Если вы определяете Path в терминах MachineName, приложение создает исключение при работе в автономном режиме, так как контроллер домена требуется для преобразования пути. Поэтому при работе в автономном режиме FormatName необходимо использовать для синтаксиса Path .

Свойства MachineName, Pathи QueueName связаны. MachineName Изменение свойства приводит к изменению Path свойства. Он построен на основе новых MachineName и QueueName. Path При изменении (например, для использования синтаксиса имени формата) свойства и QueueName сбрасываются MachineName для ссылки на новую очередь. QueueName Если свойство пусто, Path параметру присваивается Журнал очередь указанного компьютера.

В следующей таблице показано, доступно ли это свойство в различных режимах рабочей группы.

Режим рабочей группы	Доступно
Локальный компьютер	Да
Имя локального компьютера и прямого формата	Да
Удаленный компьютер	Да
Имя удаленного компьютера и прямого формата	Нет

См. также раздел

• QueueName
• Path
• FormatName
• GetPublicQueues()
• GetMessageQueueEnumerator()