MessageQueue.MachineName 속성

정의

메시지 큐가 있는 컴퓨터의 이름을 가져오거나 설정합니다.Gets or sets the name of the computer where the Message Queuing queue is located.

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; }
member this.MachineName : string with get, set
Public Property MachineName As String

속성 값

큐가 있는 컴퓨터의 이름입니다.The name of the computer where the queue is located. 메시지 큐의 기본값은 "."이며, 이는 로컬 컴퓨터를 나타냅니다.The Message Queuing default is ".", the local computer.

특성

예외

MachineNamenull인 경우The MachineName is null.
또는-or-

컴퓨터 이름이 잘못되었습니다(예: 구문이 잘못된 경우).The name of the computer is not valid, possibly because the syntax is incorrect.

메시지 큐 메서드에 액세스하는 동안 오류가 발생한 경우An error occurred when accessing a Message Queuing method.

예제

다음 코드 예제를 가져오고 메시지 큐의 값을 설정 MachineName 속성입니다.The following code example gets and sets the value of a message queue's MachineName property.

// 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합니다.The MachineName is an integral component of the friendly name syntax of the queue Path. 다음 표에서 해당 이름을 사용 하 여 큐 경로 식별 하려는 경우 지정 된 형식의 큐에 대 한 사용 해야 하는 구문을 보여 줍니다.The following table shows the syntax you should use for a queue of a specified type when you want to identify the queue path using its friendly name.

큐 유형Queue type 구문Syntax
공개 큐Public queue MachineName\QueueName
개인 큐Private queue MachineName\Private$\QueueName
저널 큐Journal queue MachineName\QueueName\Journal$
컴퓨터 저널 큐Machine journal queue MachineName\Journal$
컴퓨터 배달 못 한 편지 큐Machine dead-letter queue MachineName\Deadletter$
컴퓨터 트랜잭션 배달 못 한 편지 큐Machine transactional dead-letter queue MachineName\XactDeadletter$

사용 하 여 "."를 지정할 때 로컬 컴퓨터에 대 한는 MachineName합니다.Use "." for the local computer when specifying the MachineName. 컴퓨터 이름에만이 속성에 대 한 예를 들어 인식 Server0합니다.Only the computer name is recognized for this property, for example, Server0. MachineName 속성 IP 주소 형식은 지원 하지 않습니다.The MachineName property does not support the IP address format.

정의 하는 경우는 Path 의 측면에서 MachineName, 애플리케이션 도메인 컨트롤러는 경로 변환에 대 한 필수 사항 이므로 오프 라인으로 작업 하는 경우 예외를 throw 합니다.If you define the Path in terms of the MachineName, the application throws an exception when working offline because the domain controller is required for path translation. 따라서 사용 해야 합니다는 FormatName 에 대 한는 Path 오프 라인으로 작업 하는 경우에 구문이 있습니다.Therefore, you must use the FormatName for the Path syntax when working offline.

MachineName, Path, 및 QueueName 속성 관련 됩니다.The MachineName, Path, and QueueName properties are related. 변경 된 MachineName 속성 원인의 Path 변경할 속성입니다.Changing the MachineName property causes the Path property to change. 새에서 빌드되어 MachineName 하며 QueueName합니다.It is built from the new MachineName and the QueueName. 변경 합니다 Path (예: 형식 이름 구문을 사용 하 여) 다시 설정 합니다 MachineNameQueueName 새 큐를 참조 하는 속성입니다.Changing the Path (for example, to use the format name syntax) resets the MachineName and QueueName properties to refer to the new queue. 경우는 QueueName 속성이 비어 있으면는 Path 지정할 컴퓨터의 업무 일지 큐에 설정 됩니다.If the QueueName property is empty, the Path is set to the Journal queue of the computer you specify.

다음 표에서이 속성은 다양 한 작업 그룹 모드에서 사용할 수 있는지 여부를 보여 줍니다.The following table shows whether this property is available in various Workgroup modes.

작업 그룹 모드Workgroup mode 사용 가능Available
로컬 컴퓨터Local computer Yes
로컬 컴퓨터와 직접 형식 이름Local computer and direct format name Yes
원격 컴퓨터Remote computer Yes
원격 컴퓨터와 직접 형식 이름Remote computer and direct format name 아니요No

적용 대상

추가 정보