Класс 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.

Иерархия наследования

System. . :: . .Object
  Microsoft.SqlServer.Management.Smo. . :: . .SmoObjectBase
    Microsoft.SqlServer.Management.Smo. . :: . .SqlSmoObject
      Microsoft.SqlServer.Management.Smo. . :: . .NamedSmoObject
        Microsoft.SqlServer.Management.Smo..::..LinkedServer

Пространство имен:  Microsoft.SqlServer.Management.Smo
Сборка:  Microsoft.SqlServer.Smo (в Microsoft.SqlServer.Smo.dll)

Синтаксис

'Декларация
<PhysicalFacetAttribute> _
<EvaluationModeAttribute(AutomatedPolicyEvaluationMode.CheckOnSchedule)> _
Public NotInheritable Class LinkedServer _
    Inherits NamedSmoObject _
    Implements ISfcSupportsDesignMode, ICreatable, IDroppable, IAlterable,  _
    IScriptable
'Применение
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

Тип LinkedServer обеспечивает доступ к следующим элементам.

Конструкторы

	Имя	Описание
	LinkedServer() () () ()	Initializes a new instance of the LinkedServer object.
	LinkedServer(Server, String)	Initializes a new instance of the LinkedServer object on the specified instance of SQL Server and with the specified name.

В начало

Свойства

	Имя	Описание
	Catalog	Gets or sets the database to be used when the linked server is made through a connection to an OLE DB provider.
	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.
	CollationName	Gets or sets the name of the collation to use when sorting data from the linked server.
	ConnectTimeout	Gets or sets the number of seconds to wait for a connection to be established with the linked server before timing out.
	DataAccess	Gets or sets the Boolean property value that specifies whether data can be accessed on the linked server.
	DataSource	Gets or sets the data source to be used when the linked server is made through a connection to an OLE DB provider.
	DateLastModified	Gets the date and time when the linked server was last modified.
	DistPublisher	Gets or sets a Boolean property value that specifies whether the linked server is participating in replication as a distribution Publisher.
	Distributor	Gets or sets a Boolean property value that specifies whether the linked server is participating in replication as a distribution Publisher.
	ExecuteForScalar	Возвращает или задает значение свойства типа Boolean, указывающее, настроен ли объект для выполнения в скалярном режиме. (Производный от SqlSmoObject.)
	ID	Gets the ID value that uniquely identifies the linked server.
	IsPromotionofDistributedTransactionsForRPCEnabled	Gets or sets a Boolean property value that specifies whether the promotion of distributed transaction for RPC (remote procedure calls) is enabled.
	IsTouched	Возвращает значение свойства типа Boolean, указывающее, были ли свойства объекта обновлены, но еще не сохранены на сервере. (Производный от SqlSmoObject.)
	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.
	LinkedServerLogins	Represents a collection of LinkedServerLogin objects. Each LinkedServerLogin object represents a linked server login defined on the linked server.
	Location	Gets or sets the description of the location of the linked server.
	Name	Gets or sets the name of the object. (Производный от NamedSmoObject.)
	ObjectInSpace	Возвращает значение свойства типа Boolean, указывающее, существует ли объект изолированно или же он явно или неявно подключен к экземпляру SQL Server. (Производный от SqlSmoObject.)
	Parent	Gets or sets the Server object that is the parent of the LinkedServer object.
	ProductName	Gets or sets the name of the product to which SQL Server can connect through the OLE DB Provider.
	Properties	Возвращает коллекцию объектов Property, представляющих свойства объекта. (Производный от SqlSmoObject.)
	ProviderName	Gets or sets the name of the OLE DB provider used to connect to the linked server.
	ProviderString	Gets or sets the connection string used to connect to a linked server by way of the OLE DB Provider.
	Publisher	Gets or sets a Boolean property value that specifies whether the linked server is a replication Publisher or not.
	QueryTimeout	Gets or sets the time in seconds to wait for a query to execute before timing out.
	Rpc	Gets or sets the Boolean property value that specifies whether the linked server supports remote procedure calls (RPCs).
	RpcOut	The Boolean property value that specifies whether the linked server supports remote procedure calls (RPCs) with output parameters.
	ScalarResult	Возвращает скалярный результат для объекта, на который ссылаются. (Производный от SqlSmoObject.)
	State	Gets the state of the referenced object. (Производный от SmoObjectBase.)
	Subscriber	Gets or sets the Boolean property value that specifies whether the linked server is a replication Subscriber.
	Urn	Возвращает значение адреса универсального имени ресурса (URN), которое однозначно идентифицирует объект. (Производный от SqlSmoObject.)
	UserData	Gets or sets user-defined data associated with the referenced object. (Производный от SmoObjectBase.)
	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.

В начало

Методы

	Имя	Описание
	AddDatabaseContext(StringCollection)	Добавляет контекст базы данных в коллекцию запросов, определенную параметром queries. (Производный от SqlSmoObject.)
	AddDatabaseContext(StringCollection, ScriptingOptions)	Добавляет контекст базы данных в коллекцию запросов, определяемую параметром queries при использовании указанных параметров создания скриптов. (Производный от SqlSmoObject.)
	Alter	Updates any LinkedServer object property changes on the instance of SQL Server.
	AlterImpl	Активирует событие изменения объекта. (Производный от SqlSmoObject.)
	AlterImplFinish	Метод, вызываемый при завершении события изменения объекта. (Производный от SqlSmoObject.)
	AlterImplInit	Метод, вызываемый при инициализации события изменения объекта. (Производный от SqlSmoObject.)
	AlterImplWorker	Вызывает методы изменения. (Производный от SqlSmoObject.)
	BindDefaultImpl	Связывает элементы по умолчанию, определенные параметрами. (Производный от SqlSmoObject.)
	BindRuleImpl	Связывает схему правил с правилом и столбцами, определенными параметрами. (Производный от SqlSmoObject.)
	CheckCollation	Проверяет порядок параметров создания скриптов в методе сортировки, определенном параметром collationName. (Производный от SqlSmoObject.)
	CheckObjectState() () () ()	Проверяет состояние связанного объекта. (Производный от SqlSmoObject.)
	CheckObjectState(Boolean)	Проверяет состояние связанного объекта с возможностью указать исключение, возникающее, если объект еще не создан. (Производный от SqlSmoObject.)
	CheckObjectStateImpl	Проверяет состояние объекта SqlSmoObject. (Производный от SqlSmoObject.)
	CheckVersion100	Проверяет, является ли SQL Server версией SQL Server 2008. (Производный от SqlSmoObject.)
	CheckVersion80	Проверяет правильность объекта в SQL Server 2000. (Производный от SqlSmoObject.)
	CheckVersion80SP3	Проверяет правильность объекта в SQL Server 2000 с пакетом обновления 3 (SP3). (Производный от SqlSmoObject.)
	CheckVersion90	Проверяет правильность объекта в SQL Server 2005. (Производный от SqlSmoObject.)
	CheckVersionBelow90	Проверяет, является ли SQL Server более ранней версией, чем SQL Server 2005. (Производный от SqlSmoObject.)
	CleanObject	Устанавливает объект в неизмененное исходное состояние. (Производный от SqlSmoObject.)
	Create	Creates a linked server on the instance of SQL Server as defined by the LinkedServer object.
	CreateImpl	Создает объект с параметрами создания скриптов. (Производный от SqlSmoObject.)
	CreateImplFinish	Метод, вызываемый при завершении события создания. (Производный от SqlSmoObject.)
	CreateImplInit	Метод, вызываемый при инициализации события создания. (Производный от SqlSmoObject.)
	Discover	Находит список типа Object. (Производный от SqlSmoObject.)
	Drop() () () ()	Removes the reference to the linked server from the instance of SQL Server.
	Drop(Boolean)	Removes the reference to the linked server from the instance of SQL Server.
	DropImpl	Удаляет объект SqlSmoObject. (Производный от SqlSmoObject.)
	DropImplWorker	Вызывает методы удаления. (Производный от SqlSmoObject.)
	EnumColumns() () () ()	Enumerates a list of columns that can be accessed on the linked server.
	EnumColumns(String)	Enumerates a list of columns that can be accessed on the linked server for a specified table.
	EnumColumns(String, String)	Enumerates a list of columns that can be accessed on the linked server for a specified table and schema.
	EnumColumns(String, String, String)	Enumerates a list of columns that can be accessed on the linked server for a specified table, schema, and database.
	EnumColumns(String, String, String, String)	Enumerates a list of columns that can be accessed on the linked server for a specified column.
	EnumScriptImpl	Перечисляет сценарии, заданные параметром so. (Производный от SqlSmoObject.)
	EnumScriptImplWorker	Вызывает методы, перечисляющие заданные параметром so сценарии. (Производный от SqlSmoObject.)
	EnumScriptImplWorkerSOChanged	Возвращает строку IEnumerable, описывающую параметры создания скриптов объекта. (Производный от SqlSmoObject.)
	EnumTables() () () ()	Enumerates a list of tables that are available on the linked server.
	EnumTables(String)	Enumerates a list of tables that are available on the linked server for a specified table name.
	EnumTables(String, String)	Enumerates a list of tables that are available on the linked server for a specified table name and schema.
	EnumTables(String, String, String)	Enumerates a list of tables that are available on the linked server for a specified table name, schema, and database.
	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.
	Equals	(Производный от Object.)
	ExecuteNonQuery	(Производный от SqlSmoObject.)
	Finalize	(Производный от Object.)
	FormatSqlVariant	Форматирует объект как имеющий тип SqlVariant. (Производный от SqlSmoObject.)
	GenerateDataSpaceFileStreamScript	Формирует скрипт, создающий файл данных. (Производный от SqlSmoObject.)
	GenerateDataSpaceScript	Формирует скрипт, выделяющий пространство в файле данных. (Производный от SqlSmoObject.)
	GetBindDefaultScript	Возвращает скрипт, привязывающий значения по умолчанию, определенные параметрами defSchema и defName. (Производный от SqlSmoObject.)
	GetBindRuleScript	Возвращает скрипт, указывающий правила привязки. (Производный от SqlSmoObject.)
	GetBoolParameter(StringBuilder, ScriptingOptions, String, String, Int32%)	Назначает параметр типа boolean объекта SqlSmoObject. (Производный от SqlSmoObject.)
	GetBoolParameter(StringBuilder, ScriptingOptions, String, String, Int32%, Boolean)	Назначает свойство типа boolean объекта SqlSmoObject. (Производный от SqlSmoObject.)
	GetDateTimeParameter	Назначает свойство типа datetime объекта SqlSmoObject. (Производный от SqlSmoObject.)
	GetDateTimeParameterAsInt	Назначает свойство типа datetime объекта SqlSmoObject в виде целочисленного значения, если свойство типа datetime не равно NULL. (Производный от SqlSmoObject.)
	GetDBName	Возвращает имя базы данных, связанной с объектом. (Производный от SqlSmoObject.)
	GetEnumParameter	Назначает свойство перечисления SqlSmoObject. (Производный от SqlSmoObject.)
	GetFragOptionString	Возвращает объект FragmentationOption в виде строкового значения. (Производный от SqlSmoObject.)
	GetGuidParameter	Назначает свойство Guid объекта SqlSmoObject. (Производный от SqlSmoObject.)
	GetHashCode	(Производный от Object.)
	GetParameter(StringBuilder, ScriptingOptions, String, String, Int32%)	Назначает параметр объекта SqlSmoObject. (Производный от SqlSmoObject.)
	GetParameter(StringBuilder, ScriptingOptions, String, String, Int32%, Boolean)	Назначает параметр объекта SqlSmoObject. (Производный от SqlSmoObject.)
	GetPropValue	Возвращает значение свойства объекта SqlSmoObject. (Производный от SqlSmoObject.)
	GetPropValueOptional	Возвращает значение свойства объекта SqlSmoObject. (Производный от SqlSmoObject.)
	GetPropValueOptionalAllowNull	Возвращает значение свойства объекта SqlSmoObject. (Производный от SqlSmoObject.)
	GetRealValue	Возвращает значение свойства объекта SqlSmoObject. (Производный от SqlSmoObject.)
	GetScriptingOptionsForCreate	Возвращает параметры ScriptingOptions объектаSqlSmoObject. (Производный от SqlSmoObject.)
	GetServerName	Возвращает имя экземпляра SQL Server, с которым связан объект. (Производный от SqlSmoObject.)
	GetServerObject	Возвращает сервер объекта SqlSmoObject. (Производный от SqlSmoObject.)
	GetSqlServerVersionName	Возвращает имя версии экземпляра SQL Server, с которым связан объект. (Производный от SqlSmoObject.)
	GetStringParameter(StringBuilder, ScriptingOptions, String, String, Int32%)	Назначает параметр типа string объекта SqlSmoObject. (Производный от SqlSmoObject.)
	GetStringParameter(StringBuilder, ScriptingOptions, String, String, Int32%, Boolean)	Назначает параметр типа string объекта SqlSmoObject. (Производный от SqlSmoObject.)
	GetTimeSpanParameterAsInt	Назначает параметр временного диапазона объекта SqlSmoObject. (Производный от SqlSmoObject.)
	GetType	(Производный от Object.)
	GetUrnRecursive(StringBuilder)	Присваивает объект Urn объекту SqlSmoObject. (Производный от SqlSmoObject.)
	GetUrnRecursive(StringBuilder, UrnIdOption)	Присваивает объект Urn объекту SqlSmoObject. (Производный от SqlSmoObject.)
	ImplInitialize	Инициализирует поля объекта SqlSmoObject. (Производный от SqlSmoObject.)
	Initialize() () () ()	Инициализирует объект и инициирует загрузку свойств. (Производный от SqlSmoObject.)
	Initialize(Boolean)	Инициализирует объект и инициирует загрузку свойств. (Производный от SqlSmoObject.)
	IsObjectDirty	Проверяет, было ли изменено свойство объекта, еще не сохраненное в экземпляре SQL Server. (Производный от SqlSmoObject.)
	IsObjectInitialized	Проверяет, был ли объект инициализирован. (Производный от SqlSmoObject.)
	IsObjectInSpace	Проверяет, является ли объект изолированным или подключенным к экземпляру SQL Server. (Производный от SqlSmoObject.)
	IsVersion80SP3	Определяет, является ли SQL Server версией SQL Server 2000 с пакетом обновления 3 (SP3). (Производный от SqlSmoObject.)
	IsVersion90AndAbove	Определяет, является ли SQL Server версией SQL Server 2005 или более поздней. (Производный от SqlSmoObject.)
	MarkDropped	Устанавливает состояние SqlSmoState для удаления. (Производный от SqlSmoObject.)
	MarkForDropImpl	Устанавливает состояние SqlSmoState для удаления. (Производный от SqlSmoObject.)
	MemberwiseClone	(Производный от Object.)
	PostAlter	Метод, активируемый после изменения SqlSmoObject. (Производный от SqlSmoObject.)
	PostCreate	Метод, активируемый после создания SqlSmoObject. (Производный от SqlSmoObject.)
	PostDrop	Метод, активируемый после удаления SqlSmoObject. (Производный от SqlSmoObject.)
	Refresh	Обновляет объект и извлекает свойства объекта при следующем обращении. (Производный от SqlSmoObject.)
	RenameImpl	Указано только в ознакомительных целях. Не поддерживается. Совместимость с будущими версиями не гарантируется. (Производный от NamedSmoObject.)
	RenameImplWorker	Указано только в ознакомительных целях. Не поддерживается. Совместимость с будущими версиями не гарантируется. (Производный от NamedSmoObject.)
	Script() () () ()	Generates a Transact-SQL script that can be used to re-create the linked server registration.
	Script(ScriptingOptions)	Generates a Transact-SQL script that can be used to re-create the linked server registration as specified by the script options.
	ScriptAlter	Изменяет SqlSmoObject в соответствии с параметрами. (Производный от SqlSmoObject.)
	ScriptChangeOwner	This method supports the SMO infrastructure and is not intended to be used directly from your code. (Производный от NamedSmoObject.)
	ScriptCreate	Изменяет SqlSmoObject в соответствии с параметрами. (Производный от SqlSmoObject.)
	ScriptDdl	Вызывает исключение InvalidSmoOperationException. (Производный от SqlSmoObject.)
	ScriptDrop	Вызывает исключение InvalidSmoOperationException. (Производный от SqlSmoObject.)
	ScriptImpl() () () ()	Возвращает коллекцию скриптов SqlSmoObject. (Производный от SqlSmoObject.)
	ScriptImpl(ScriptingOptions)	Возвращает коллекцию скриптов SqlSmoObject. (Производный от SqlSmoObject.)
	ScriptImplWorker	Возвращает коллекцию скриптов SqlSmoObject. (Производный от SqlSmoObject.)
	ScriptOwner	Alters the script owner authorization. (Производный от NamedSmoObject.)
	ScriptRename	This method supports the SMO infrastructure and is not intended to be used directly from your code. (Производный от NamedSmoObject.)
	SetParentImpl	Устанавливает родительский объект объекта SqlSmoObject в значение параметра newParent. (Производный от SqlSmoObject.)
	SetSchemaOwned	Sets the schema owned value. (Производный от NamedSmoObject.)
	TestConnection	Tests the connection to a linked server.
	ToString	Возвращает String, представляющее объект, на который ссылаются. (Производный от SqlSmoObject.)
	TouchImpl	Не реализовано. (Производный от SqlSmoObject.)
	UnbindDefaultImpl	Отменяет привязку столбцов по умолчанию для объекта SqlSmoObject. (Производный от SqlSmoObject.)
	UnbindRuleImpl	Отменяет привязку правил для объекта SqlSmoObject. (Производный от SqlSmoObject.)
	Validate	Validates the state of an object. (Производный от SmoObjectBase.)

В начало

События

	Имя	Описание
	PropertyChanged	Представляет событие, возникающее при изменении свойства. (Производный от SqlSmoObject.)
	PropertyMetadataChanged	Представляет событие, возникающее при изменении метаданных свойства. (Производный от SqlSmoObject.)

В начало

Поля

	Имя	Описание
	m_ExtendedProperties	Представляет свойство, определенное для расширения свойств, предоставляемых объектом SqlSmoObject. (Производный от SqlSmoObject.)
	singletonParent	Представляет единственного родителя. (Производный от SqlSmoObject.)

В начало

Явные реализации интерфейса

	Имя	Описание
	IAlienObject. . :: . .Discover	Находит любые зависимости. Не ссылайтесь на этот элемент непосредственно из кода. Он поддерживает работу инфраструктуры SQL Server. (Производный от SqlSmoObject.)
	IAlienObject. . :: . .GetDomainRoot	Возвращает корневой элемент домена. (Производный от SqlSmoObject.)
	IAlienObject. . :: . .GetParent	Возвращает родительский объект для данного объекта. Не ссылайтесь на этот элемент непосредственно из кода. Он поддерживает работу инфраструктуры SQL Server. (Производный от SqlSmoObject.)
	IAlienObject. . :: . .GetPropertyType	Возвращает тип указанного свойства. (Производный от SqlSmoObject.)
	IAlienObject. . :: . .GetPropertyValue	Возвращает значение указанного свойства. (Производный от SqlSmoObject.)
	IAlienObject. . :: . .GetUrn	Возвращает универсальное имя ресурса для объекта. Не ссылайтесь на этот элемент непосредственно из кода. Он поддерживает работу инфраструктуры SQL Server. (Производный от SqlSmoObject.)
	IAlienObject. . :: . .Resolve	Возвращает экземпляр, содержащий данные об объекте из универсального имени ресурса для объекта. (Производный от SqlSmoObject.)
	IAlienObject. . :: . .SetObjectState	Задает состоянию объекта указанное значение SfcObjectState. (Производный от SqlSmoObject.)
	IAlienObject. . :: . .SetPropertyValue	Устанавливает значение свойства. (Производный от SqlSmoObject.)
	ISfcPropertyProvider. . :: . .GetPropertySet	Возвращает ссылку на интерфейс для набора свойств данного объекта. Не ссылайтесь на этот элемент непосредственно из кода. Он поддерживает работу инфраструктуры SQL Server. (Производный от SqlSmoObject.)
	ISfcSupportsDesignMode. . :: . .IsDesignMode	Gets a Boolean value that specifies whether the linked server supports design mode.

В начало

Замечания

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

Все общие статические члены этого типа (Shared в Microsoft Visual Basic) можно использовать в многопоточных операциях. Безопасная многопоточная работа с членами экземпляров типа не гарантируется. 

Примеры

Использование связанных серверов в объектах SMO

Безопасность многопоточности

Любые открытые статический (Shared в Visual Basic) элементы этого типа потокобезопасны. Потокобезопасность с элементами экземпляров не гарантируется.

См. также

Справочник

Пространство имен Microsoft.SqlServer.Management.Smo

Другие ресурсы

Связь серверов

sp_addlinkedserver (Transact-SQL)