Compartir a través de

  • Artículo

Clase LinkedServer

A LinkedServer object represents a database system other than SQL Server and is linked to the current instance of SQL Server by using an OLE DB driver.

Espacio de nombres:  Microsoft.SqlServer.Management.Smo
Ensamblado:  Microsoft.SqlServer.Smo (en Microsoft.SqlServer.Smo.dll)

Sintaxis

'Declaración
<PhysicalFacetAttribute> _
<EvaluationModeAttribute(AutomatedPolicyEvaluationMode.CheckOnSchedule)> _
Public NotInheritable Class LinkedServer _
    Inherits NamedSmoObject _
    Implements ISfcSupportsDesignMode, ICreatable, IDroppable, IAlterable,  _
    IScriptable
'Uso
Dim instance As LinkedServer

[PhysicalFacetAttribute]
[EvaluationModeAttribute(AutomatedPolicyEvaluationMode.CheckOnSchedule)]
public sealed class LinkedServer : NamedSmoObject, 
    ISfcSupportsDesignMode, ICreatable, IDroppable, IAlterable, IScriptable

[PhysicalFacetAttribute]
[EvaluationModeAttribute(AutomatedPolicyEvaluationMode::CheckOnSchedule)]
public ref class LinkedServer sealed : public NamedSmoObject, 
    ISfcSupportsDesignMode, ICreatable, IDroppable, IAlterable, IScriptable

[<SealedAttribute>]
[<PhysicalFacetAttribute>]
[<EvaluationModeAttribute(AutomatedPolicyEvaluationMode.CheckOnSchedule)>]
type LinkedServer =  
    class
        inherit NamedSmoObject
        interface ISfcSupportsDesignMode
        interface ICreatable
        interface IDroppable
        interface IAlterable
        interface IScriptable
    end

public final class LinkedServer extends NamedSmoObject implements ISfcSupportsDesignMode, ICreatable, IDroppable, IAlterable, IScriptable

El tipo LinkedServer expone los siguientes miembros.

Constructores

  Nombre Descripción
Método público LinkedServer() () () () Initializes a new instance of the LinkedServer object.
Método público LinkedServer(Server, String) Initializes a new instance of the LinkedServer object on the specified instance of SQL Server and with the specified name.

Arriba

Propiedades

  Nombre Descripción
Propiedad pública Catalog Gets or sets the database to be used when the linked server is made through a connection to an OLE DB provider.
Propiedad pública CollationCompatible Gets or sets the Boolean property value that specifies whether the default collation of the linked server is compatible with the default collation on the local instance of SQL Server.
Propiedad pública CollationName Gets or sets the name of the collation to use when sorting data from the linked server.
Propiedad pública ConnectTimeout Gets or sets the number of seconds to wait for a connection to be established with the linked server before timing out.
Propiedad pública DataAccess Gets or sets the Boolean property value that specifies whether data can be accessed on the linked server.
Propiedad pública DataSource Gets or sets the data source to be used when the linked server is made through a connection to an OLE DB provider.
Propiedad pública DateLastModified Gets the date and time when the linked server was last modified.
Propiedad pública DistPublisher Gets or sets a Boolean property value that specifies whether the linked server is participating in replication as a distribution Publisher.
Propiedad pública Distributor Gets or sets a Boolean property value that specifies whether the linked server is participating in replication as a distribution Publisher.
Propiedad protegida ExecuteForScalar Obtiene o establece el valor de propiedad Boolean que especifica si el objeto está establecido para que se ejecute para la opción escalar. (Se hereda de SqlSmoObject.)
Propiedad pública ID Gets the ID value that uniquely identifies the linked server.
Propiedad pública IsPromotionofDistributedTransactionsForRPCEnabled Gets or sets a Boolean property value that specifies whether the promotion of distributed transaction for RPC (remote procedure calls) is enabled.
Propiedad protegida IsTouched Obtiene el valor de propiedad Boolean que especifica si las propiedades del objeto se han actualizado pero todavía no son persistentes en el servidor. (Se hereda de SqlSmoObject.)
Propiedad pública LazySchemaValidation Gets or sets the Boolean property value that specifies whether the schema used by the linked server data is validated when the local instance of SQL Server is idle or not.
Propiedad pública LinkedServerLogins Represents a collection of LinkedServerLogin objects. Each LinkedServerLogin object represents a linked server login defined on the linked server.
Propiedad pública Location Gets or sets the description of the location of the linked server.
Propiedad pública Name Gets or sets the name of the object. (Se hereda de NamedSmoObject.)
Propiedad protegida ObjectInSpace Obtiene el valor de propiedad Boolean que especifica si el objeto existe en aislamiento, o si está conectado directa o indirectamente con la instancia de SQL Server. (Se hereda de SqlSmoObject.)
Propiedad pública Parent Gets or sets the Server object that is the parent of the LinkedServer object.
Propiedad pública ProductName Gets or sets the name of the product to which SQL Server can connect through the OLE DB Provider.
Propiedad pública Properties Obtiene una colección de objetos Property que representa las propiedades del objeto. (Se hereda de SqlSmoObject.)
Propiedad pública ProviderName Gets or sets the name of the OLE DB provider used to connect to the linked server.
Propiedad pública ProviderString Gets or sets the connection string used to connect to a linked server by way of the OLE DB Provider.
Propiedad pública Publisher Gets or sets a Boolean property value that specifies whether the linked server is a replication Publisher or not.
Propiedad pública QueryTimeout Gets or sets the time in seconds to wait for a query to execute before timing out.
Propiedad pública Rpc Gets or sets the Boolean property value that specifies whether the linked server supports remote procedure calls (RPCs).
Propiedad pública RpcOut The Boolean property value that specifies whether the linked server supports remote procedure calls (RPCs) with output parameters.
Propiedad protegida ScalarResult Obtiene el resultado escalar para el objeto al que se hace referencia. (Se hereda de SqlSmoObject.)
Propiedad pública State Gets the state of the referenced object. (Se hereda de SmoObjectBase.)
Propiedad pública Subscriber Gets or sets the Boolean property value that specifies whether the linked server is a replication Subscriber.
Propiedad pública Urn Obtiene el valor de la dirección URN (nombre de recursos uniforme) que identifica de forma única el objeto. (Se hereda de SqlSmoObject.)
Propiedad pública UserData Gets or sets user-defined data associated with the referenced object. (Se hereda de SmoObjectBase.)
Propiedad pública UseRemoteCollation Gets or sets the Boolean property value that specifies whether to use the collation that is associated with the data from the linked server.

Arriba

Métodos

  Nombre Descripción
Método protegido AddDatabaseContext(StringCollection) Agrega el contexto de la base de datos a la colección de consultas identificada por el parámetro queries. (Se hereda de SqlSmoObject.)
Método protegido AddDatabaseContext(StringCollection, ScriptingOptions) Agrega el contexto de la base de datos a la colección de consultas identificada por el parámetro queries usando las opciones de scripting especificadas. (Se hereda de SqlSmoObject.)
Método público Alter Updates any LinkedServer object property changes on the instance of SQL Server. 
Método protegido AlterImpl Activa el evento de objeto modificado. (Se hereda de SqlSmoObject.)
Método protegido AlterImplFinish Método al que se llama cuando finaliza el evento de objeto modificado. (Se hereda de SqlSmoObject.)
Método protegido AlterImplInit Método al que se llama cuando se inicializa el evento de objeto modificado. (Se hereda de SqlSmoObject.)
Método protegido AlterImplWorker Llama a los métodos Alter. (Se hereda de SqlSmoObject.)
Método protegido BindDefaultImpl Enlaza los elementos predeterminados identificados por los parámetros. (Se hereda de SqlSmoObject.)
Método protegido BindRuleImpl Enlaza el esquema de la regla a la regla y las columnas identificadas por los parámetros. (Se hereda de SqlSmoObject.)
Método protegido CheckCollation Comprueba el orden de las opciones de scripting por el método de intercalación identificado por el parámetro collationName. (Se hereda de SqlSmoObject.)
Método protegido CheckObjectState() () () () Valida el estado del objeto al que se hace referencia. (Se hereda de SqlSmoObject.)
Método protegido CheckObjectState(Boolean) Valida el estado del objeto al que se hace referencia, con la opción de especificar que se produzca una excepción si todavía no se ha creado el objeto. (Se hereda de SqlSmoObject.)
Método protegido CheckObjectStateImpl Comprueba el estado de un objeto SqlSmoObject. (Se hereda de SqlSmoObject.)
Método protegido CheckVersion100 Comprueba si la versión de SQL Server es SQL Server 2008. (Se hereda de SqlSmoObject.)
Método protegido CheckVersion80 Comprueba la validez del objeto en SQL Server 2000. (Se hereda de SqlSmoObject.)
Método protegido CheckVersion80SP3 Comprueba la validez del objeto en SQL Server 2000 SP3. (Se hereda de SqlSmoObject.)
Método protegido CheckVersion90 Comprueba la validez del objeto en SQL Server 2005. (Se hereda de SqlSmoObject.)
Método protegido CheckVersionBelow90 Comprueba si la versión de SQL Server es anterior a SQL Server 2005. (Se hereda de SqlSmoObject.)
Método protegido CleanObject Establece el objeto en el estado no modificado. (Se hereda de SqlSmoObject.)
Método público Create Creates a linked server on the instance of SQL Server as defined by the LinkedServer object.
Método protegido CreateImpl Crea un objeto con opciones de scripting. (Se hereda de SqlSmoObject.)
Método protegido CreateImplFinish Método al que se llama cuando finaliza el evento Create. (Se hereda de SqlSmoObject.)
Método protegido CreateImplInit Método al que se llama cuando se inicializa el evento Create. (Se hereda de SqlSmoObject.)
Método público Discover Detecta una lista del tipo Object. (Se hereda de SqlSmoObject.)
Método público Drop() () () () Removes the reference to the linked server from the instance of SQL Server.
Método público Drop(Boolean) Removes the reference to the linked server from the instance of SQL Server.
Método protegido DropImpl Quita un SqlSmoObject. (Se hereda de SqlSmoObject.)
Método protegido DropImplWorker Llama a los métodos Drop. (Se hereda de SqlSmoObject.)
Método público EnumColumns() () () () Enumerates a list of columns that can be accessed on the linked server.
Método público EnumColumns(String) Enumerates a list of columns that can be accessed on the linked server for a specified table.
Método público EnumColumns(String, String) Enumerates a list of columns that can be accessed on the linked server for a specified table and schema.
Método público EnumColumns(String, String, String) Enumerates a list of columns that can be accessed on the linked server for a specified table, schema, and database.
Método público EnumColumns(String, String, String, String) Enumerates a list of columns that can be accessed on the linked server for a specified column.
Método protegido EnumScriptImpl Enumera los scripts especificados por el parámetro so. (Se hereda de SqlSmoObject.)
Método protegido EnumScriptImplWorker Llama a los métodos que enumeran los scripts especificados por el parámetro so. (Se hereda de SqlSmoObject.)
Método protegido EnumScriptImplWorkerSOChanged Devuelve una cadena IEnumerable que describe las opciones de scripting de un objeto. (Se hereda de SqlSmoObject.)
Método público EnumTables() () () () Enumerates a list of tables that are available on the linked server.
Método público EnumTables(String) Enumerates a list of tables that are available on the linked server for a specified table name.
Método público EnumTables(String, String) Enumerates a list of tables that are available on the linked server for a specified table name and schema.
Método público EnumTables(String, String, String) Enumerates a list of tables that are available on the linked server for a specified table name, schema, and database.
Método público EnumTables(String, String, String, LinkedTableType) Enumerates a list of tables that are available on the linked server for a specified table name, schema, database, and linked table type.
Método público Equals (Se hereda de Object.)
Método protegido ExecuteNonQuery (Se hereda de SqlSmoObject.)
Método protegido Finalize (Se hereda de Object.)
Método protegido FormatSqlVariant Da formato a un objeto como tipo SqlVariant. (Se hereda de SqlSmoObject.)
Método protegido GenerateDataSpaceFileStreamScript Genera un script para crear el archivo de datos. (Se hereda de SqlSmoObject.)
Método protegido GenerateDataSpaceScript Genera un script para asignar espacio en el archivo de datos. (Se hereda de SqlSmoObject.)
Método protegido GetBindDefaultScript Obtiene el script que enlaza los valores predeterminados especificados por los parámetros defSchema y defName. (Se hereda de SqlSmoObject.)
Método protegido GetBindRuleScript Obtiene el script que especifica las reglas de enlace. (Se hereda de SqlSmoObject.)
Método protegido GetBoolParameter(StringBuilder, ScriptingOptions, String, String, Int32%) Asigna un parámetro booleano del objeto SqlSmoObject. (Se hereda de SqlSmoObject.)
Método protegido GetBoolParameter(StringBuilder, ScriptingOptions, String, String, Int32%, Boolean) Asigna una propiedad booleana del objeto SqlSmoObject. (Se hereda de SqlSmoObject.)
Método protegido GetDateTimeParameter Asigna la propiedad datetime del objeto SqlSmoObject. (Se hereda de SqlSmoObject.)
Método protegido GetDateTimeParameterAsInt Asigna la propiedad datetime del objeto SqlSmoObject como un valor entero si la propiedad datetime no es NULL. (Se hereda de SqlSmoObject.)
Método protegido GetDBName Obtiene el nombre de la base de datos asociada al objeto. (Se hereda de SqlSmoObject.)
Método protegido GetEnumParameter Asigna una propiedad enumeration del objeto SqlSmoObject. (Se hereda de SqlSmoObject.)
Método protegido GetFragOptionString Obtiene un objeto FragmentationOption como un valor de cadena. (Se hereda de SqlSmoObject.)
Método protegido GetGuidParameter Asigna una propiedad Guid del objeto SqlSmoObject. (Se hereda de SqlSmoObject.)
Método público GetHashCode (Se hereda de Object.)
Método protegido GetParameter(StringBuilder, ScriptingOptions, String, String, Int32%) Asigna un parámetro del objeto SqlSmoObject. (Se hereda de SqlSmoObject.)
Método protegido GetParameter(StringBuilder, ScriptingOptions, String, String, Int32%, Boolean) Asigna un parámetro del objeto SqlSmoObject. (Se hereda de SqlSmoObject.)
Método protegido GetPropValue Obtiene un valor de propiedad del objeto SqlSmoObject. (Se hereda de SqlSmoObject.)
Método protegido GetPropValueOptional Obtiene un valor de propiedad del objeto SqlSmoObject. (Se hereda de SqlSmoObject.)
Método protegido GetPropValueOptionalAllowNull Obtiene un valor de propiedad del objeto SqlSmoObject. (Se hereda de SqlSmoObject.)
Método protegido GetRealValue Obtiene un valor de propiedad del objeto SqlSmoObject. (Se hereda de SqlSmoObject.)
Método protegido GetScriptingOptionsForCreate Obtiene ScriptingOptions para el objeto SqlSmoObject. (Se hereda de SqlSmoObject.)
Método protegido GetServerName Obtiene el nombre de la instancia de SQL Server con la que está asociado el objeto. (Se hereda de SqlSmoObject.)
Método protegido GetServerObject Obtiene el servidor del objeto SqlSmoObject. (Se hereda de SqlSmoObject.)
Método protegido GetSqlServerVersionName Obtiene el nombre de la versión de la instancia de SQL Server con la que está asociado el objeto. (Se hereda de SqlSmoObject.)
Método protegido GetStringParameter(StringBuilder, ScriptingOptions, String, String, Int32%) Asigna un parámetro de cadena del objeto SqlSmoObject. (Se hereda de SqlSmoObject.)
Método protegido GetStringParameter(StringBuilder, ScriptingOptions, String, String, Int32%, Boolean) Asigna un parámetro de cadena del objeto SqlSmoObject. (Se hereda de SqlSmoObject.)
Método protegido GetTimeSpanParameterAsInt Asigna un parámetro de intervalo de tiempo del objeto SqlSmoObject. (Se hereda de SqlSmoObject.)
Método público GetType (Se hereda de Object.)
Método protegido GetUrnRecursive(StringBuilder) Asigna un objeto Urn del objeto SqlSmoObject. (Se hereda de SqlSmoObject.)
Método protegido GetUrnRecursive(StringBuilder, UrnIdOption) Asigna un objeto Urn del objeto SqlSmoObject. (Se hereda de SqlSmoObject.)
Método protegido ImplInitialize Inicializa los campos del objeto SqlSmoObject. (Se hereda de SqlSmoObject.)
Método público Initialize() () () () Inicializa el objeto y fuerza la carga de las propiedades. (Se hereda de SqlSmoObject.)
Método público Initialize(Boolean) Inicializa el objeto y fuerza la carga de las propiedades. (Se hereda de SqlSmoObject.)
Método protegido IsObjectDirty Comprueba si se han modificado las propiedades del objeto y los cambios todavía no son persistentes en la instancia de SQL Server. (Se hereda de SqlSmoObject.)
Método protegido IsObjectInitialized Comprueba si se ha inicializado el objeto. (Se hereda de SqlSmoObject.)
Método protegido IsObjectInSpace Comprueba si el objeto está aislado o conectado a la instancia de SQL Server. (Se hereda de SqlSmoObject.)
Método protegido IsVersion80SP3 Determina si la versión de SQL Server es SQL Server 2000 con SP3. (Se hereda de SqlSmoObject.)
Método protegido IsVersion90AndAbove Determina si la versión de SQL Server es SQL Server 2005 o posterior. (Se hereda de SqlSmoObject.)
Método protegido MarkDropped Establece SqlSmoState en quitado. (Se hereda de SqlSmoObject.)
Método protegido MarkForDropImpl Establece SqlSmoState en quitado. (Se hereda de SqlSmoObject.)
Método protegido MemberwiseClone (Se hereda de Object.)
Método protegido PostAlter Método que se activa tras modificar el objeto SqlSmoObject. (Se hereda de SqlSmoObject.)
Método protegido PostCreate Método que se activa tras crear el objeto SqlSmoObject. (Se hereda de SqlSmoObject.)
Método protegido PostDrop Método que se activa tras quitar el objeto SqlSmoObject. (Se hereda de SqlSmoObject.)
Método público Refresh Actualiza el objeto y recupera las propiedades la próxima vez que se tiene acceso al objeto. (Se hereda de SqlSmoObject.)
Método protegido RenameImpl Solamente se identifica con fines informativos. No compatible. La compatibilidad con versiones posteriores no está garantizada. (Se hereda de NamedSmoObject.)
Método protegido RenameImplWorker Solamente se identifica con fines informativos. No compatible. La compatibilidad con versiones posteriores no está garantizada. (Se hereda de NamedSmoObject.)
Método público Script() () () () Generates a Transact-SQL script that can be used to re-create the linked server registration.
Método público Script(ScriptingOptions) Generates a Transact-SQL script that can be used to re-create the linked server registration as specified by the script options.
Método protegido ScriptAlter Modifica el objeto SqlSmoObject de acuerdo con los parámetros. (Se hereda de SqlSmoObject.)
Método protegido ScriptChangeOwner This method supports the SMO infrastructure and is not intended to be used directly from your code. (Se hereda de NamedSmoObject.)
Método protegido ScriptCreate Modifica el objeto SqlSmoObject de acuerdo con los parámetros. (Se hereda de SqlSmoObject.)
Método protegido ScriptDdl Inicia InvalidSmoOperationException. (Se hereda de SqlSmoObject.)
Método protegido ScriptDrop Inicia InvalidSmoOperationException. (Se hereda de SqlSmoObject.)
Método protegido ScriptImpl() () () () Obtiene una colección de los scripts del objeto SqlSmoObject. (Se hereda de SqlSmoObject.)
Método protegido ScriptImpl(ScriptingOptions) Obtiene una colección de los scripts del objeto SqlSmoObject. (Se hereda de SqlSmoObject.)
Método protegido ScriptImplWorker Obtiene una colección de los scripts del objeto SqlSmoObject. (Se hereda de SqlSmoObject.)
Método protegido ScriptOwner Alters the script owner authorization. (Se hereda de NamedSmoObject.)
Método protegido ScriptRename This method supports the SMO infrastructure and is not intended to be used directly from your code. (Se hereda de NamedSmoObject.)
Método protegido SetParentImpl Establece el elemento primario del objeto SqlSmoObject en el parámetro newParent. (Se hereda de SqlSmoObject.)
Método protegido SetSchemaOwned Sets the schema owned value. (Se hereda de NamedSmoObject.)
Método público TestConnection Tests the connection to a linked server.
Método público ToString Devuelve un valor String que representa el objeto al que se hace referencia. (Se hereda de SqlSmoObject.)
Método protegido TouchImpl No implementado. (Se hereda de SqlSmoObject.)
Método protegido UnbindDefaultImpl Desenlaza las columnas predeterminadas del objeto SqlSmoObject. (Se hereda de SqlSmoObject.)
Método protegido UnbindRuleImpl Desenlaza las reglas del objeto SqlSmoObject. (Se hereda de SqlSmoObject.)
Método público Validate Validates the state of an object. (Se hereda de SmoObjectBase.)

Arriba

Eventos

  Nombre Descripción
Evento público PropertyChanged Representa el evento que se produce cuando se cambia una propiedad. (Se hereda de SqlSmoObject.)
Evento público PropertyMetadataChanged Representa el evento que se produce cuando cambian los metadatos de la propiedad. (Se hereda de SqlSmoObject.)

Arriba

Campos

  Nombre Descripción
Campo protegido m_ExtendedProperties Representa una propiedad definida para extender las propiedades proporcionadas por un objeto SqlSmoObject. (Se hereda de SqlSmoObject.)
Campo protegido singletonParent Representa el elemento primario singleton. (Se hereda de SqlSmoObject.)

Arriba

Implementaciones de interfaces explícitas

  Nombre Descripción
Implementación de interfaces explícitasMétodo privado IAlienObject. . :: . .Discover Detecta las dependencias. No haga referencia directamente a este miembro en el código. Admite la infraestructura de SQL Server. (Se hereda de SqlSmoObject.)
Implementación de interfaces explícitasMétodo privado IAlienObject. . :: . .GetDomainRoot Devuelve la raíz del dominio. (Se hereda de SqlSmoObject.)
Implementación de interfaces explícitasMétodo privado IAlienObject. . :: . .GetParent Obtiene el elemento primario de este objeto. No haga referencia directamente a este miembro en el código. Admite la infraestructura de SQL Server. (Se hereda de SqlSmoObject.)
Implementación de interfaces explícitasMétodo privado IAlienObject. . :: . .GetPropertyType Obtiene el tipo de la propiedad especificada. (Se hereda de SqlSmoObject.)
Implementación de interfaces explícitasMétodo privado IAlienObject. . :: . .GetPropertyValue Obtiene el valor de la propiedad especificada. (Se hereda de SqlSmoObject.)
Implementación de interfaces explícitasMétodo privado IAlienObject. . :: . .GetUrn Obtiene el Nombre de recursos uniforme del objeto. No haga referencia directamente a este miembro en el código. Admite la infraestructura de SQL Server. (Se hereda de SqlSmoObject.)
Implementación de interfaces explícitasMétodo privado IAlienObject. . :: . .Resolve Obtiene la instancia que contiene la información sobre el objeto del Nombre de recursos unificado del objeto. (Se hereda de SqlSmoObject.)
Implementación de interfaces explícitasMétodo privado IAlienObject. . :: . .SetObjectState Establece el estado del objeto en el valor SfcObjectState especificado. (Se hereda de SqlSmoObject.)
Implementación de interfaces explícitasMétodo privado IAlienObject. . :: . .SetPropertyValue Establece el valor de la propiedad. (Se hereda de SqlSmoObject.)
Implementación de interfaces explícitasMétodo privado ISfcPropertyProvider. . :: . .GetPropertySet Obtiene la referencia de interfaz al conjunto de propiedades de este objeto. No haga referencia directamente a este miembro en el código. Admite la infraestructura de SQL Server. (Se hereda de SqlSmoObject.)
Implementación de interfaces explícitasPropiedad privada ISfcSupportsDesignMode. . :: . .IsDesignMode Gets a Boolean value that specifies whether the linked server supports design mode.

Arriba

Comentarios

To get LinkedServer object properties, users can be a member of the public fixed server role.

To set LinkedServer object properties, users must have ALTER ANY LINKED SERVER permission on the server or be a member of the sysadmin fixed server role.

To create or drop a linked server, users must have ALTER ANY LINKED SERVER permission on the server or be a member of the sysadmin fixed server role.

To enumerate tables or columns on the linked server, users must have SELECT permission on the schema.

Thread Safety

Todos los miembros estáticos (compartidos en Microsoft Visual Basic) públicos de este tipo son seguros para operaciones multiproceso. No se garantiza que los miembros de instancia sean seguros para subprocesos. 

Seguridad para subprocesos

Cualquier miembro público static (Shared en Visual Basic) de este tipo es seguro para subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.