ProtocolFieldCollection オブジェクト内の指定された場所に ProtocolField オブジェクトを追加します。
名前空間: Microsoft.SqlServer.Management.Nmo
アセンブリ: Microsoft.SqlServer.Smo (microsoft.sqlserver.smo.dll 内)
構文
'宣言
Public Sub Add ( _
protocolField As ProtocolField, _
insertAtPosition As Integer _
)
public void Add (
ProtocolField protocolField,
int insertAtPosition
)
public:
void Add (
ProtocolField^ protocolField,
int insertAtPosition
)
public void Add (
ProtocolField protocolField,
int insertAtPosition
)
public function Add (
protocolField : ProtocolField,
insertAtPosition : int
)
パラメータ
- protocolField
コレクションに追加する ProtocolField オブジェクトです。
- insertAtPosition
ProtocolField オブジェクトを追加する、コレクション内の 0 から始まる位置を示す Int32 です。
解説
このメソッドを使用すると、プロトコル フィールド リスト内の特定の位置にプロトコル フィールドを挿入できます。各プロトコル フィールドは、テーブル内の列になります。プロトコル フィールド データの使用方法によっては、列の順序が重要になる場合があります。
現在その位置にあるプロトコル フィールドと、後続のすべてのプロトコル フィールドが、リスト内の 1 つ下の位置に移動します。
配置したアプリケーションにプロトコル フィールドを追加した後、インスタンスを更新すると、対応する通知クラスがいったん削除され、再作成されます。同時に、この通知クラスが使用していたテーブルも削除され、再作成されます。既存の通知クラスのテーブル内に存在するデータは、すべて完全に削除されます。
使用例
次の例は、プロトコル フィールドのコレクションの 2 番目の位置にプロトコル フィールドを追加する方法を示しています。
ProtocolField fileProtocolField3 =
new ProtocolField(fileProtocol, "Price");
fileProtocolField3.FieldReference = "FormattedPrice";
fileProtocol.ProtocolFields.Add(fileProtocolField3, 1);
Dim fileProtocolField3 As ProtocolField = _
New ProtocolField(fileProtocol, "Price")
fileProtocolField3.FieldReference = "FormattedPrice"
fileProtocol.ProtocolFields.Add(fileProtocolField3, 1)
スレッド セーフ
この型の public static (Microsoft Visual Basic では共有 ) メンバは、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。
プラットフォーム
開発プラットフォーム
サポートされているプラットフォームの一覧については、「SQL Server 2005 のインストールに必要なハードウェアおよびソフトウェア」を参照してください。
対象プラットフォーム
サポートされているプラットフォームの一覧については、「SQL Server 2005 のインストールに必要なハードウェアおよびソフトウェア」を参照してください。
参照
関連項目
ProtocolFieldCollection Class
ProtocolFieldCollection Members
Microsoft.SqlServer.Management.Nmo Namespace
Instance.Update Method