TransSubscription Constructeurs
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Crée une instance de la classe TransSubscription.
Surcharges
| Nom | Description |
|---|---|
| TransSubscription() |
Crée une instance de la classe TransSubscription. |
| TransSubscription(String, String, String, String, ServerConnection) |
Crée une nouvelle instance de la TransSubscription classe avec la publication, la base de données, la base de données Abonné et l’Abonné spécifiées, ainsi qu’avec la connexion spécifiée à l’instance de Microsoft SQL Server. |
Remarques
Texte mis à jour :17 juillet 2006
Le tableau suivant montre les valeurs de propriété par défaut pour une nouvelle instance de TransSubscription. Toutes les propriétés qui ne sont pas explicitement énumérées dans ce tableau sont initialisées en une null valeur.
| Propriété | Valeur par défaut |
|---|---|
| AgentOffload | false |
| AgentSchedule | Une valeur de 99991231 pour ActiveEndDate Une valeur de 235959 pour ActiveEndTime Une valeur de 0 pour ActiveStartDate Une valeur de 0 pour ActiveStartTime Une valeur de 1 pour FrequencyInterval Une valeur de 0 pour FrequencyRecurrenceFactor Une valeur de First pour FrequencyRelativeIntervalUne valeur de Minute pour FrequencySubDayUne valeur de 5 pour FrequencySubDayInterval Une valeur de Continuously pour FrequencyType |
| CachePropertyChanges | false |
| CreateSyncAgentByDefault | true |
| EnabledForSynchronizationManager | false |
| FullSubscription | true |
| IsExistingObject | false |
| LoopBackDetection | true |
| Status | Une valeur de Inactive pour SubscriptionState |
| SubscriberDatasourceType | Une valeur de SqlServer pour SubscriberType |
| SubscriberSecurity | Une valeur de true pour WindowsAuthentication |
| SubscriberType | Une valeur de ReadOnly pour TransSubscriberType |
| SubscriptionType | Une valeur de Push pour SubscriptionOption |
| SynchronizationAgent | Un exemple de TransSynchronizationAgent la publication associée à l’abonnement que vous créez. |
| SyncType | Une valeur de Automatic pour SubscriptionSyncType |
TransSubscription()
Crée une instance de la classe TransSubscription.
public:
TransSubscription();
public TransSubscription();
Public Sub New ()
Exemples
// 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
Remarques
Le constructeur par défaut initialise tous les champs à leurs valeurs par défaut.
Voir aussi
S’applique à
TransSubscription(String, String, String, String, ServerConnection)
Crée une nouvelle instance de la TransSubscription classe avec la publication, la base de données, la base de données Abonné et l’Abonné spécifiées, ainsi qu’avec la connexion spécifiée à l’instance de Microsoft SQL Server.
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)
Paramètres
- publicationName
- String
Une String valeur qui spécifie le nom de la publication transactionnelle ou instantanée.
- databaseName
- String
Une String valeur qui spécifie le nom de la base de données contenant la publication, ou le nom de la base de données de distribution pour un non-SQL Server Publisher.
- subscriptionDBName
- String
Une String valeur qui spécifie le nom de la base de données par abonnement.
- connectionContext
- ServerConnection
Un ServerConnection objet qui représente une connexion avec le Publisher ou avec le Distributeur pour un abonnement à une non-SQL Server Publisher.