MessageContractMemberAttribute クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
MessageBodyMemberAttribute および MessageHeaderAttributeの基本メンバーを宣言します。
public ref class MessageContractMemberAttribute abstract : Attribute
public abstract class MessageContractMemberAttribute : Attribute
type MessageContractMemberAttribute = class
inherit Attribute
Public MustInherit Class MessageContractMemberAttribute
Inherits Attribute
- 継承
- 派生
例
次のコード例では、 MessageContractAttribute、 MessageHeaderAttribute、および MessageBodyMemberAttribute 属性 (すべて MessageContractMemberAttributeから継承) を使用して、操作で使用するカスタム型指定メッセージを作成するカスタム メッセージ コントラクトを示します。 この場合、SOAP メッセージの body 要素にシリアル化される 3 つのメンバーがあります。 sourceAccount、 targetAccount、および amount 値 ( transactionAmountという名前の要素にシリアル化されます)。 さらに、 IsAudited SOAP ヘッダー要素は http://schemas.contosobank.com/auditing/2005 名前空間に存在し、 sourceAccount は暗号化され、デジタル署名されます。
Note
Operation型とAccount型には、データ コントラクトが必要です。
[MessageContract]
public class BankingTransaction
{
[MessageHeader]
public Operation operation;
[MessageHeader(Namespace="http://schemas.contosobank.com/auditing/2005")]
public bool IsAudited;
[MessageBody(ProtectionLevel=ProtectionLevel.EncryptAndSign)]
public Account sourceAccount;
[MessageBody]
public Account targetAccount;
[MessageBody(Name="transactionAmount")]
public int amount;
注釈
このクラスには、SOAP メッセージのすべての部分に共通するプロパティが含まれています。 たとえば、すべての部分に名前と名前空間があり、セキュリティ レベルが適用される可能性があります。
既定の SOAP エンベロープ自体を変更せずに SOAP 本文の内容のシリアル化を制御する方法については、「 System.Runtime.Serialization.DataContractAttribute、 サービス コントラクトでのデータ転送の指定、 およびデータ コントラクトの使用」を参照してください。
メッセージ コントラクトの作成の詳細については、「メッセージ コントラクトの 使用」を参照してください。
コンストラクター
| 名前 | 説明 |
|---|---|
| MessageContractMemberAttribute() |
MessageContractMemberAttribute クラスの新しいインスタンスを初期化します。 |
プロパティ
| 名前 | 説明 |
|---|---|
| HasProtectionLevel |
派生クラスでオーバーライドされると、メンバーに保護レベルが割り当てられているかどうかを示す値を取得します。 |
| Name |
このメンバーに対応する要素の名前を指定します。 |
| Namespace |
このメンバーに対応する要素の名前空間を指定します。 |
| ProtectionLevel |
メンバーを as-is送信するか、署名するか、署名して暗号化するかを指定します。 |
| TypeId |
派生クラスで実装されている場合は、この Attributeの一意の識別子を取得します。 (継承元 Attribute) |
メソッド
| 名前 | 説明 |
|---|---|
| Equals(Object) |
このインスタンスが指定したオブジェクトと等しいかどうかを示す値を返します。 (継承元 Attribute) |
| GetHashCode() |
このインスタンスのハッシュ コードを返します。 (継承元 Attribute) |
| GetType() |
現在のインスタンスの Type を取得します。 (継承元 Object) |
| IsDefaultAttribute() |
派生クラスでオーバーライドされた場合、このインスタンスの値が派生クラスの既定値であるかどうかを示します。 (継承元 Attribute) |
| Match(Object) |
派生クラスでオーバーライドされた場合、このインスタンスが指定したオブジェクトと等しいかどうかを示す値を返します。 (継承元 Attribute) |
| MemberwiseClone() |
現在の Objectの簡易コピーを作成します。 (継承元 Object) |
| ToString() |
現在のオブジェクトを表す文字列を返します。 (継承元 Object) |
明示的なインターフェイスの実装
| 名前 | 説明 |
|---|---|
| _Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) |
一連の名前を対応する一連のディスパッチ識別子に割り当てます。 (継承元 Attribute) |
| _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) |
インターフェイスの型情報を取得するために使用できるオブジェクトの型情報を取得します。 (継承元 Attribute) |
| _Attribute.GetTypeInfoCount(UInt32) |
オブジェクトが提供する型情報インターフェイスの数 (0 または 1) を取得します。 (継承元 Attribute) |
| _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) |
オブジェクトによって公開されるプロパティとメソッドへのアクセスを提供します。 (継承元 Attribute) |