MessageQueue.QueueName プロパティ

.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

C#

public string QueueName { get;
 set; }

C++

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

J#

/** @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 プロパティに対し、値の取得と設定を行うコード例を次に示します。

C#

// 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);

J#

// 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());

.NET Framework のセキュリティ

• 直前の呼び出し元に対する完全な信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細については、「」を参照してください。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0

参照

関連項目
MessageQueue クラス
MessageQueue メンバ
System.Messaging 名前空間
MessageQueue.Path プロパティ
MessageQueue.MachineName プロパティ