MessageQueue.MachineName Свойство

Определение

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

System.Messaging

Сборка:

System.Messaging.dll

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

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

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

Атрибуты

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, приложение создает исключение при работе в автономном режиме, так как контроллер домена требуется для перевода путей. Поэтому при работе в автономном режиме Path необходимо использовать FormatName синтаксис.

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

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

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

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

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