MessageQueue.QueueName プロパティとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

MessageQueue.QueueName プロパティ

キューを識別する表示名を取得または設定します。

名前空間: System.Messaging
アセンブリ: System.Messaging (system.messaging.dll 内)
構文

Visual Basic (宣言)

Public Property QueueName As
 String

Visual Basic (使用法)

Dim instance As MessageQueue
Dim value As String

value = instance.QueueName

instance.QueueName = value

public string QueueName { get;
 set; }

C++

public:
property String^ QueueName {
    String^ get ();
    void set (String^ value);
}

/** @property */
public String get_QueueName ()

/** @property */
public void set_QueueName (String value)

JScript

public function get QueueName
 () : String

public function set QueueName
 (value : String)

プロパティ値
この MessageQueue が参照するキューを識別する名前。値を null 参照 (Visual Basic では Nothing) にすることはできません。

例外

例外の種類	条件
ArgumentException	キュー名が null 参照 (Visual Basic では Nothing) です。

解説

QueueName と MachineName を組み合わせて、キューのわかりやすい Path 名を作成できます。Path プロパティの表示名の構文は、キューの種類によって異なります。詳細については、次の表を参照してください。

キューの種類	構文
パブリックキュー	MachineName\QueueName
プライベートキュー	MachineName\Private$\QueueName
ジャーナルキュー	MachineName\QueueName\Journal$

ローカルコンピュータを表す場合は "." を使用します。

QueueName プロパティを変更すると、Path プロパティが影響を受けます。MachineName プロパティを設定せずに QueueName を設定すると、Path プロパティは .\QueueName になります。それ以外の場合、Path は MachineName \ QueueName になります。

このプロパティが各種のワークグループモードで使用できるかどうかを次の表に示します。

ワークグループモード	使用可否
ローカルコンピュータ	○
ローカルコンピュータと直接書式名	○
リモートコンピュータ	○
リモートコンピュータと直接書式名	×

使用例

メッセージキューの QueueName プロパティに対し、値の取得と設定を行うコード例を次に示します。

// Set the queue's QueueName property value.
queue.QueueName = "Example Queue";

// Display the new value of the queue's QueueName property.
Console.WriteLine("MessageQueue.QueueName: {0}", queue.QueueName);

// Set the queue's QueueName property value.
queue.set_QueueName("Example Queue");
// Display the new value of the queue's QueueName property.
Console.WriteLine("MessageQueue.QueueName: {0}", 
    queue.get_QueueName());