TransSubscription コンストラクター
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
TransSubscription クラスの新しいインスタンスを作成します。
オーバーロード
TransSubscription() |
TransSubscription クラスの新しいインスタンスを作成します。 |
TransSubscription(String, String, String, String, ServerConnection) |
指定したパブリケーション、データベース、サブスクライバー、およびサブスクライバー データベースを使用し、指定した Microsoft SQL Server のインスタンスへの接続を使用して、 クラスの新しいTransSubscriptionインスタンスを作成します。 |
注釈
更新されたテキスト:2006 年 7 月 17 日
次の表に、TransSubscription の新しいインスタンスに使用される既定のプロパティ値を示します。 この表に明示されていないプロパティは、null
値に初期化されます。
プロパティ | 既定値 |
---|---|
AgentOffload | false |
AgentSchedule | 99991231 の値 ActiveEndDate 235959 の値 ActiveEndTime の値は 0 です。 ActiveStartDate の値は 0 です。 ActiveStartTime FrequencyInterval の場合、値 1 になります。 の値は 0 です。 FrequencyRecurrenceFactor FrequencyRelativeInterval の場合、値 First になります。FrequencySubDay の場合、値 Minute になります。の値は 5 です。 FrequencySubDayInterval FrequencyType の場合、値 Continuously になります。 |
CachePropertyChanges | false |
CreateSyncAgentByDefault | true |
EnabledForSynchronizationManager | false |
FullSubscription | true |
IsExistingObject | false |
LoopBackDetection | true |
Status | SubscriptionState の場合、値 Inactive になります。 |
SubscriberDatasourceType | SubscriberType の場合、値 SqlServer になります。 |
SubscriberSecurity | WindowsAuthentication の場合、値 true になります。 |
SubscriberType | TransSubscriberType の場合、値 ReadOnly になります。 |
SubscriptionType | SubscriptionOption の場合、値 Push になります。 |
SynchronizationAgent | 作成したサブスクリプションに関連するパブリケーションの TransSynchronizationAgent のインスタンスになります。 |
SyncType | SubscriptionSyncType の場合、値 Automatic になります。 |
TransSubscription()
TransSubscription クラスの新しいインスタンスを作成します。
public:
TransSubscription();
public TransSubscription ();
Public Sub New ()
例
// Define the Publisher, publication, and databases.
string publicationName = "AdvWorksProductTran";
string publisherName = publisherInstance;
string subscriberName = subscriberInstance;
string subscriptionDbName = "AdventureWorks2012Replica";
string publicationDbName = "AdventureWorks2012";
//Create a connection to the Publisher.
ServerConnection conn = new ServerConnection(publisherName);
// Create the objects that we need.
TransPublication publication;
TransSubscription subscription;
try
{
// Connect to the Publisher.
conn.Connect();
// Ensure that the publication exists and that
// it supports push subscriptions.
publication = new TransPublication();
publication.Name = publicationName;
publication.DatabaseName = publicationDbName;
publication.ConnectionContext = conn;
if (publication.IsExistingObject)
{
if ((publication.Attributes & PublicationAttributes.AllowPush) == 0)
{
publication.Attributes |= PublicationAttributes.AllowPush;
}
// Define the push subscription.
subscription = new TransSubscription();
subscription.ConnectionContext = conn;
subscription.SubscriberName = subscriberName;
subscription.PublicationName = publicationName;
subscription.DatabaseName = publicationDbName;
subscription.SubscriptionDBName = subscriptionDbName;
// Specify the Windows login credentials for the Distribution Agent job.
subscription.SynchronizationAgentProcessSecurity.Login = winLogin;
subscription.SynchronizationAgentProcessSecurity.Password = winPassword;
// By default, subscriptions to transactional publications are synchronized
// continuously, but in this case we only want to synchronize on demand.
subscription.AgentSchedule.FrequencyType = ScheduleFrequencyType.OnDemand;
// Create the push subscription.
subscription.Create();
}
else
{
// Do something here if the publication does not exist.
throw new ApplicationException(String.Format(
"The publication '{0}' does not exist on {1}.",
publicationName, publisherName));
}
}
catch (Exception ex)
{
// Implement the appropriate error handling here.
throw new ApplicationException(String.Format(
"The subscription to {0} could not be created.", publicationName), ex);
}
finally
{
conn.Disconnect();
}
' Define the Publisher, publication, and databases.
Dim publicationName As String = "AdvWorksProductTran"
Dim publisherName As String = publisherInstance
Dim subscriberName As String = subscriberInstance
Dim subscriptionDbName As String = "AdventureWorks2012Replica"
Dim publicationDbName As String = "AdventureWorks2012"
'Create a connection to the Publisher.
Dim conn As ServerConnection = New ServerConnection(publisherName)
' Create the objects that we need.
Dim publication As TransPublication
Dim subscription As TransSubscription
Try
' Connect to the Publisher.
conn.Connect()
' Ensure that the publication exists and that
' it supports push subscriptions.
publication = New TransPublication()
publication.Name = publicationName
publication.DatabaseName = publicationDbName
publication.ConnectionContext = conn
If publication.IsExistingObject Then
If (publication.Attributes And PublicationAttributes.AllowPush) = 0 Then
publication.Attributes = publication.Attributes _
Or PublicationAttributes.AllowPush
End If
' Define the push subscription.
subscription = New TransSubscription()
subscription.ConnectionContext = conn
subscription.SubscriberName = subscriberName
subscription.PublicationName = publicationName
subscription.DatabaseName = publicationDbName
subscription.SubscriptionDBName = subscriptionDbName
' Specify the Windows login credentials for the Distribution Agent job.
subscription.SynchronizationAgentProcessSecurity.Login = winLogin
subscription.SynchronizationAgentProcessSecurity.Password = winPassword
' By default, subscriptions to transactional publications are synchronized
' continuously, but in this case we only want to synchronize on demand.
subscription.AgentSchedule.FrequencyType = ScheduleFrequencyType.OnDemand
' Create the push subscription.
subscription.Create()
Else
' Do something here if the publication does not exist.
Throw New ApplicationException(String.Format( _
"The publication '{0}' does not exist on {1}.", _
publicationName, publisherName))
End If
Catch ex As Exception
' Implement the appropriate error handling here.
Throw New ApplicationException(String.Format( _
"The subscription to {0} could not be created.", publicationName), ex)
Finally
conn.Disconnect()
End Try
注釈
既定のコンストラクターは、すべてのフィールドを既定値に初期化します。
こちらもご覧ください
適用対象
TransSubscription(String, String, String, String, ServerConnection)
指定したパブリケーション、データベース、サブスクライバー、およびサブスクライバー データベースを使用し、指定した Microsoft SQL Server のインスタンスへの接続を使用して、 クラスの新しいTransSubscriptionインスタンスを作成します。
public:
TransSubscription(System::String ^ publicationName, System::String ^ databaseName, System::String ^ subscriberName, System::String ^ subscriptionDBName, Microsoft::SqlServer::Management::Common::ServerConnection ^ connectionContext);
public TransSubscription (string publicationName, string databaseName, string subscriberName, string subscriptionDBName, Microsoft.SqlServer.Management.Common.ServerConnection connectionContext);
new Microsoft.SqlServer.Replication.TransSubscription : string * string * string * string * Microsoft.SqlServer.Management.Common.ServerConnection -> Microsoft.SqlServer.Replication.TransSubscription
Public Sub New (publicationName As String, databaseName As String, subscriberName As String, subscriptionDBName As String, connectionContext As ServerConnection)
パラメーター
- connectionContext
- ServerConnection
ServerConnection SQL Server以外のパブリッシャーへのサブスクリプションのパブリッシャーまたはディストリビューターへの接続を表す オブジェクト。