MessageQueue.MachineName Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Получает или задает имя компьютера, на котором расположена очередь 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 StringЗначение свойства
Имя компьютера, на котором расположена очередь. По умолчанию службой Message Queuing используется значение ".", т. е. локальный компьютер.
- Атрибуты
Исключения
Значение параметра MachineName — null.
-или-
Недопустимое имя компьютера. Причиной может быть неверный синтаксис.
При обращении к методу службы очереди сообщений возникла ошибка.
Примеры
В следующем примере кода возвращается и задается значение свойства очереди 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 параметру присваивается Журнал очередь указанного компьютера.
В следующей таблице показано, доступно ли это свойство в различных режимах рабочей группы.
| Режим рабочей группы | Доступно |
|---|---|
| Локальный компьютер | Да |
| Имя локального компьютера и прямого формата | Да |
| Удаленный компьютер | Да |
| Имя удаленного компьютера и прямого формата | Нет |
