Прочитать на английском

Поделиться через


MessageQueue.MachineName Свойство

Определение

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

[System.ComponentModel.Browsable(false)]
[System.Messaging.MessagingDescription("MQ_MachineName")]
public string MachineName { get; set; }

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

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

Атрибуты

Исключения

Значение параметра MachineNamenull. -или-

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

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

Примеры

В следующем примере кода возвращается и задается значение свойства очереди 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 параметру присваивается Журнал очередь указанного компьютера.

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

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

Применяется к

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