ComUdtElement クラス

定義

名前空間:: System.ServiceModel.Configuration

アセンブリ:: System.ServiceModel.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

サービスコントラクトに含めるユーザー定義型 (UDT) を表します。このクラスは継承できません。

public ref class ComUdtElement sealed : System::Configuration::ConfigurationElement

public sealed class ComUdtElement : System.Configuration.ConfigurationElement

type ComUdtElement = class
    inherit ConfigurationElement

Public NotInheritable Class ComUdtElement
Inherits ConfigurationElement

継承: Object

ConfigurationElement
ComUdtElement

例

次の例では、この目的で構成ファイルの <userDefinedTypes> セクションに 2 つの特定の UDT を追加する方法を示します。

注釈

COM+ 統合ランタイムは、タイプライブラリを調べることでサービスを作成します。 COM+ コンポーネントに VARIANTを渡すメソッドが含まれている場合、システムは実行時前に渡される実際の型を判断できません。そのため、ユーザー定義型 (UDT) を VARIANT内で渡そうとすると、シリアル化の既知の型ではないため、失敗します。

この問題を回避するには、UDT を構成ファイルに追加して、適切なサービスコントラクトに既知の型として含めることができます。そのためには、UDT とコントラクト、つまりそれを使用する元の COM インターフェイスを一意に識別する必要があります。

次の例では、この目的で構成ファイルの <userDefinedTypes> セクションに 2 つの特定の UDT を追加する方法を示します。

<userDefinedType>要素の属性は次のように定義されます。

typeName: 読み取り可能な型名を提供する省略可能な属性。これはランタイムでは使用されませんが、リーダーが型を区別するのに役立ちます。
typeLibID: 型を定義する登録済みタイプライブラリを指定する GUID 文字列。
typeLibVersion: 型を定義するタイプライブラリのバージョンを指定する文字列。
typeDefID: 登録済みのタイプライブラリ内の特定の UDT 型を指定する GUID 文字列。

サービスが初期化されると、COM+ 統合ランタイムは、指定された型を検索し、指定したコントラクトの既知の型コレクションに追加します。

コンストラクター

名前	説明
ComUdtElement()	ComUdtElement クラスの新しいインスタンスを初期化します。
ComUdtElement(String)	指定した GUID 文字列を使用して、 ComUdtElement クラスの新しいインスタンスを初期化します。

プロパティ

名前	説明
CurrentConfiguration	現在のConfiguration インスタンスが属している構成階層を表す最上位ConfigurationElement インスタンスへの参照を取得します。 (継承元 ConfigurationElement)
ElementInformation	ElementInformation オブジェクトのカスタマイズ不可能な情報と機能を含むConfigurationElement オブジェクトを取得します。 (継承元 ConfigurationElement)
ElementProperty	ConfigurationElementProperty オブジェクト自体を表すConfigurationElement オブジェクトを取得します。 (継承元 ConfigurationElement)
EvaluationContext	ContextInformation オブジェクトの ConfigurationElement オブジェクトを取得します。 (継承元 ConfigurationElement)
HasContext	CurrentConfiguration プロパティが`null`されているかどうかを示す値を取得します。 (継承元 ConfigurationElement)
Item[ConfigurationProperty]	この構成要素のプロパティまたは属性を取得または設定します。 (継承元 ConfigurationElement)
Item[String]	この構成要素のプロパティ、属性、または子要素を取得または設定します。 (継承元 ConfigurationElement)
LockAllAttributesExcept	ロックされた属性のコレクションを取得します。 (継承元 ConfigurationElement)
LockAllElementsExcept	ロックされた要素のコレクションを取得します。 (継承元 ConfigurationElement)
LockAttributes	ロックされた属性のコレクションを取得します。 (継承元 ConfigurationElement)
LockElements	ロックされた要素のコレクションを取得します。 (継承元 ConfigurationElement)
LockItem	要素がロックされているかどうかを示す値を取得または設定します。 (継承元 ConfigurationElement)
Name	読み取り可能な型名を取得または設定します。
Properties	プロパティのコレクションを取得します。 (継承元 ConfigurationElement)
TypeDefID	登録済みのタイプライブラリ内の特定の UDT 型を識別する GUID 文字列を取得または設定します。
TypeLibID	型を定義する登録済みタイプライブラリを識別する GUID 文字列を取得または設定します。
TypeLibVersion	型を定義するタイプライブラリのバージョンを識別する文字列を取得または設定します。

メソッド

名前	説明
DeserializeElement(XmlReader, Boolean)	構成ファイルから XML を読み取ります。 (継承元 ConfigurationElement)
Equals(Object)	現在の ConfigurationElement インスタンスを指定したオブジェクトと比較します。 (継承元 ConfigurationElement)
GetHashCode()	現在の ConfigurationElement インスタンスを表す一意の値を取得します。 (継承元 ConfigurationElement)
GetTransformedAssemblyString(String)	指定したアセンブリ名の変換されたバージョンを返します。 (継承元 ConfigurationElement)
GetTransformedTypeString(String)	指定した型名の変換されたバージョンを返します。 (継承元 ConfigurationElement)
GetType()	現在のインスタンスの Type を取得します。 (継承元 Object)
Init()	ConfigurationElement オブジェクトを初期状態に設定します。 (継承元 ConfigurationElement)
InitializeDefault()	ConfigurationElement オブジェクトの既定の値セットを初期化するために使用します。 (継承元 ConfigurationElement)
IsModified()	この構成要素が、派生クラスで実装されたときに、最後に保存または読み込まれた後に変更されたかどうかを示します。 (継承元 ConfigurationElement)
IsReadOnly()	ConfigurationElement オブジェクトが読み取り専用かどうかを示す値を取得します。 (継承元 ConfigurationElement)
ListErrors(IList)	この ConfigurationElement オブジェクトおよびすべてのサブ要素の無効なプロパティエラーを、渡されたリストに追加します。 (継承元 ConfigurationElement)
MemberwiseClone()	現在の Objectの簡易コピーを作成します。 (継承元 Object)
OnDeserializeUnrecognizedAttribute(String, String)	逆シリアル化中に不明な属性が検出されたかどうかを示す値を取得します。 (継承元 ConfigurationElement)
OnDeserializeUnrecognizedElement(String, XmlReader)	逆シリアル化中に不明な要素が検出されたかどうかを示す値を取得します。 (継承元 ConfigurationElement)
OnRequiredPropertyNotFound(String)	必要なプロパティが見つからない場合に例外をスローします。 (継承元 ConfigurationElement)
PostDeserialize()	逆シリアル化後に呼び出されます。 (継承元 ConfigurationElement)
PreSerialize(XmlWriter)	シリアル化の前に呼び出されます。 (継承元 ConfigurationElement)
Reset(ConfigurationElement)	ロックやプロパティコレクションなど、 ConfigurationElement オブジェクトの内部状態をリセットします。 (継承元 ConfigurationElement)
ResetModified()	派生クラスで実装されたときに IsModified() メソッドの値を `false` にリセットします。 (継承元 ConfigurationElement)
SerializeElement(XmlWriter, Boolean)	派生クラスで実装されている場合、この構成要素の内容を構成ファイルに書き込みます。 (継承元 ConfigurationElement)
SerializeToXmlElement(XmlWriter, String)	派生クラスで実装されるときに、この構成要素の外部タグを構成ファイルに書き込みます。 (継承元 ConfigurationElement)
SetPropertyValue(ConfigurationProperty, Object, Boolean)	プロパティを指定した値に設定します。 (継承元 ConfigurationElement)
SetReadOnly()	IsReadOnly() オブジェクトとすべてのサブ要素のConfigurationElement プロパティを設定します。 (継承元 ConfigurationElement)
ToString()	現在のオブジェクトを表す文字列を返します。 (継承元 Object)
Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode)	ConfigurationElement オブジェクトを変更して、保存すべきでないすべての値を削除します。 (継承元 ConfigurationElement)

適用対象

こちらもご覧ください

Config の ComUdtElements

フィードバック

このページはお役に立ちましたか?