TransArticle コンストラクター

リファレンス

定義

名前空間:: Microsoft.SqlServer.Replication

アセンブリ:: Microsoft.SqlServer.Rmo.dll

重要

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

TransArticle クラスの新しいインスタンスを作成します。

オーバーロード

TransArticle()	TransArticle クラスの新しいインスタンスを作成します。
TransArticle(String, String, String, ServerConnection)	必要なプロパティと、指定した Microsoft SQL ServerのインスタンスTransArticleへの接続を使用して、クラスの新しいインスタンスを作成します。

注釈

更新されたテキスト:2006 年 7 月 17 日

次の表に、TransArticle の新しいインスタンスに使用される既定のプロパティ値を示します。この表に明示されていないプロパティは、null 値に初期化されます。

プロパティ	既定値
CachePropertyChanges	`false`
CommandFormat	CommandOptions の場合、値 `None` になります。
DatatypeMappingOptions	ArticleDatatypeMappingOptions の場合、値 `Default` になります。
DeleteCommand	`CALL sp_MSdel_table`¹
IdentityRangeManagementOption	IdentityRangeManagementOption の場合、値 `Manual` になります。
InsertCommand	`CALL sp_MSins_table`¹
IsExistingObject	`false`
PreCreationMethod	PreCreationOption の場合、値 `Drop` になります。
SchemaOption	CreationScriptOptions の場合、値 `PrimaryObject` になります。
Type	ArticleOptions の場合、値 `LogBased` になります。
UpdateCommand	`SCALL sp_MSupd_table`¹
VerticalPartition	`false`

¹ 詳細については、「トランザクションアーティクルに対する変更の伝達方法と、sp_addarticle (Transact-SQL)の@del_cmd、@ins_cmd、および@upd_cmdパラメーターの指定」を参照してください。

TransArticle()

TransArticle クラスの新しいインスタンスを作成します。

public:
 TransArticle();

public TransArticle ();

Public Sub New ()

例

// Define the Publisher, publication, and article names.
string publisherName = publisherInstance;
string publicationName = "AdvWorksProductTran";
string publicationDbName = "AdventureWorks2012";
string articleName = "Product";
string schemaOwner = "Production";

TransArticle article;

// Create a connection to the Publisher.
ServerConnection conn = new ServerConnection(publisherName);

// Create a filtered transactional articles in the following steps:
// 1) Create the  article with a horizontal filter clause.
// 2) Add columns to or remove columns from the article.
try
{
    // Connect to the Publisher.
    conn.Connect();

    // Define a horizontally filtered, log-based table article.
    article = new TransArticle();
    article.ConnectionContext = conn;
    article.Name = articleName;
    article.DatabaseName = publicationDbName;
    article.SourceObjectName = articleName;
    article.SourceObjectOwner = schemaOwner;
    article.PublicationName = publicationName;
    article.Type = ArticleOptions.LogBased;
    article.FilterClause = "DiscontinuedDate IS NULL";

    // Ensure that we create the schema owner at the Subscriber.
    article.SchemaOption |= CreationScriptOptions.Schema;

    if (!article.IsExistingObject)
    {
        // Create the article.
        article.Create();
    }
    else
    {
        throw new ApplicationException(String.Format(
            "The article {0} already exists in publication {1}.",
            articleName, publicationName));
    }

    // Create an array of column names to remove from the article.
    String[] columns = new String[1];
    columns[0] = "DaysToManufacture";

    // Remove the column from the article.
    article.RemoveReplicatedColumns(columns);
}
catch (Exception ex)
{
    // Implement appropriate error handling here.
    throw new ApplicationException("The article could not be created.", ex);
}
finally
{
    conn.Disconnect();
}

' Define the Publisher, publication, and article names.
Dim publisherName As String = publisherInstance
Dim publicationName As String = "AdvWorksProductTran"
Dim publicationDbName As String = "AdventureWorks2012"
Dim articleName As String = "Product"
Dim schemaOwner As String = "Production"

Dim article As TransArticle

' Create a connection to the Publisher.
Dim conn As ServerConnection = New ServerConnection(publisherName)

' Create a filtered transactional articles in the following steps:
' 1) Create the  article with a horizontal filter clause.
' 2) Add columns to or remove columns from the article.
Try
    ' Connect to the Publisher.
    conn.Connect()

    ' Define a horizontally filtered, log-based table article.
    article = New TransArticle()
    article.ConnectionContext = conn
    article.Name = articleName
    article.DatabaseName = publicationDbName
    article.SourceObjectName = articleName
    article.SourceObjectOwner = schemaOwner
    article.PublicationName = publicationName
    article.Type = ArticleOptions.LogBased
    article.FilterClause = "DiscontinuedDate IS NULL"

    ' Ensure that we create the schema owner at the Subscriber.
    article.SchemaOption = article.SchemaOption Or _
    CreationScriptOptions.Schema

    If Not article.IsExistingObject Then
        ' Create the article.
        article.Create()
    Else
        Throw New ApplicationException(String.Format( _
         "The article {0} already exists in publication {1}.", _
         articleName, publicationName))
    End If

    ' Create an array of column names to remove from the article.
    Dim columns() As String = New String(0) {}
    columns(0) = "DaysToManufacture"

    ' Remove the column from the article.
    article.RemoveReplicatedColumns(columns)
Catch ex As Exception
    ' Implement appropriate error handling here.
    Throw New ApplicationException("The article could not be created.", ex)
Finally
    conn.Disconnect()
End Try

注釈

既定のコンストラクターは、すべてのフィールドを既定値に初期化します。

適用対象

TransArticle(String, String, String, ServerConnection)

必要なプロパティと、指定した Microsoft SQL ServerのインスタンスTransArticleへの接続を使用して、クラスの新しいインスタンスを作成します。

public:
 TransArticle(System::String ^ name, System::String ^ publicationName, System::String ^ databaseName, Microsoft::SqlServer::Management::Common::ServerConnection ^ connectionContext);

public TransArticle (string name, string publicationName, string databaseName, Microsoft.SqlServer.Management.Common.ServerConnection connectionContext);

new Microsoft.SqlServer.Replication.TransArticle : string * string * string * Microsoft.SqlServer.Management.Common.ServerConnection -> Microsoft.SqlServer.Replication.TransArticle

Public Sub New (name As String, publicationName As String, databaseName As String, connectionContext As ServerConnection)

パラメーター

name: String

アーティクルの名前を指定する String 値です。

publicationName: String

トランザクションパブリケーションまたはスナップショットパブリケーションの名前を指定する String 値です。

databaseName: String

パブリケーションデータベースの名前を指定する String 値です。

connectionContext: ServerConnection

パブリッシャーへの接続を指定する ServerConnection オブジェクトの値です。

適用対象

次の方法で共有

TransArticle コンストラクター

定義

オーバーロード

注釈

TransArticle()

例

注釈

適用対象

TransArticle(String, String, String, ServerConnection)

パラメーター

適用対象

その他のリソース