CallContext.GetHeaders メソッド

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

CallContext.GetHeaders メソッド

メソッド呼び出しと共に送信するヘッダーを返します。

名前空間: System.Runtime.Remoting.Messaging
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

Public Shared Function GetHeaders
 As Header()

Visual Basic (使用法)

Dim returnValue As Header()

returnValue = CallContext.GetHeaders

C#

public static Header[] GetHeaders ()

C++

public:
static array<Header^>^ GetHeaders ()

J#

public static Header[] GetHeaders ()

JScript

public static function GetHeaders
 () : Header[]

戻り値
メソッド呼び出しと共に送信するヘッダー。

例外

例外の種類	条件
SecurityException	直前の呼び出し元に、インフラストラクチャ アクセス許可がありません。

使用例

リモート メソッドにヘッダーを送信し、リモート メソッドから制御が戻るときに、これらのヘッダーの内容をコンソールに出力するコード例を次に示します。

Visual Basic

' Array of Headers with name and values initialized.
Dim myArrSetHeader As Header() =  {New Header("Header0",
 "CallContextHeader0"), _
                                          New Header("Header1",
 "CallContextHeader1")}

' Pass the Header Array with method call.
' Header will be set in the method by'CallContext.SetHeaders' method
 in remote object.

Console.WriteLine("Remote HeaderMethod output is "
 _
                     + myService.HeaderMethod("CallContextHeader",
 myArrSetHeader))

Dim myArrGetHeader() As Header
' Get Header Array.

myArrGetHeader = CallContext.GetHeaders()
If myArrGetHeader Is Nothing
 Then
   Console.WriteLine("CallContext.GetHeaders Failed")
Else
   Console.WriteLine("Headers:")
End If

Dim myHeader As Header
For each myHeader in myArrGetHeader
   Console.WriteLine("Value in Header '{0}'
 is '{1}'.",myHeader.Name,myHeader.Value)
Next

C#

// Array of Headers with name and values initialized.
Header[] myArrSetHeader = {new Header("Header0","CallContextHeader0")
,
                             new Header("Header1","CallContextHeader1")};

// Pass the Header Array with method call.
// Header will be set in the method by'CallContext.SetHeaders' method
 in remote object.

Console.WriteLine("Remote HeaderMethod output is " +
                        myService.HeaderMethod("CallContextHeader",myArrSetHeader));

Header[] myArrGetHeader;
// Get Header Array.
myArrGetHeader=CallContext.GetHeaders();
if (null == myArrGetHeader)
   Console.WriteLine("CallContext.GetHeaders Failed");
else
   Console.WriteLine("Headers:");
foreach(Header myHeader in myArrGetHeader)
{
   Console.WriteLine("Value in Header '{0}' is '{1}'."
,myHeader.Name,myHeader.Value);
}

C++

// Array of Headers with name and values initialized.
array<Header^>^ myArrSetHeader = { gcnew Header( "Header0","CallContextHeader0"
 ),
   gcnew Header( "Header1","CallContextHeader1" ) };

// Pass the Header Array with method call.
// Header will be set in the method by'CallContext::SetHeaders' method
 in remote Object*.
Console::WriteLine( "Remote HeaderMethod output is {0}",
   myService->HeaderMethod( "CallContextHeader", myArrSetHeader ) );

array<Header^>^ myArrGetHeader;
// Get Header Array.
myArrGetHeader = CallContext::GetHeaders();
if ( nullptr == myArrGetHeader )
{
   Console::WriteLine( "CallContext::GetHeaders Failed" );
}
else
{
   Console::WriteLine( "Headers:" );
}

for each ( Header^ myHeader in myArrGetHeader
 )
{
   Console::WriteLine( "Value in Header '{0}' is '{1}'."
,
      myHeader->Name, myHeader->Value );
}

.NET Framework のセキュリティ

• SecurityPermission  (インフラストラクチャ コードを操作するために必要なアクセス許可)。要求値 : SecurityAction.LinkDemand; アクセス許可値 : SecurityPermissionFlag.Infrastructure

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, 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

参照

関連項目
CallContext クラス
CallContext メンバ
System.Runtime.Remoting.Messaging 名前空間