Article.Name 속성

정의

네임스페이스:

Microsoft.SqlServer.Replication

어셈블리:

Microsoft.SqlServer.Rmo.dll

아티클 이름을 가져오거나 설정합니다.

public:
 property System::String ^ Name { System::String ^ get(); void set(System::String ^ value); };

public string Name { get; set; }

member this.Name : string with get, set

Public Property Name As String

속성 값

String

아티클의 이름입니다.

예외

ApplicationException

기존 아티클에 대해 이 속성을 설정하는 경우

ArgumentException

이 속성을 문자가 포함 null 되거나 128자보다 긴 값null으로 설정하는 경우

예제

// 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

설명

서버에서 Name 아티클을 만들려면 호출 Create 하기 전에 속성을 설정해야 합니다. 아티클이 서버에 있으면 이 속성을 설정할 수 없습니다.

게시 Name 자 및 구독자(구독자 다시 게시용)에서 고정 서버 역할의 sysadmin 멤버가 속성을 검색할 수 있습니다. 게시 데이터베이스의 고정 데이터베이스 역할 멤버 및 PAL의 db_owner 멤버인 사용자가 검색할 수도 있습니다. 개체의 MergeArticle 경우 배포자에서 고정 데이터베이스 역할의 replmonitor 멤버가 이 속성을 검색할 수도 있습니다.

게시 Name 자에서 고정 서버 역할의 멤버가 sysadmin 속성을 설정할 수 있습니다. 게시 데이터베이스에서 고정 데이터베이스 역할의 db_owner 멤버가 설정할 수도 있습니다.

Name 검색은 트랜잭션 또는 스냅샷 복제를 위해 sp_helparticle(Transact-SQL)를 실행하거나 병합 복제를 위해 sp_helpmergearticle(Transact-SQL)를 실행하는 것과 같습니다.

설정 Name 은 트랜잭션 또는 스냅샷 복제를 위해 sp_addarticle(Transact-SQL) 를 실행하거나 병합 복제를 위해 sp_addmergearticle(Transact-SQL) 를 실행하는 것과 같습니다.

이 속성은 Name 읽기/쓰기 속성입니다.