ReportingService2010.TestConnectForDataSourceDefinition Método

Referência

Definição

Namespace:: ReportService2010

Assembly:: ReportService2010.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Testa a conexão de uma fonte de dados. Esse método oferece suporte aos testes diretos da fonte de dados.

public:
 bool TestConnectForDataSourceDefinition(ReportService2010::DataSourceDefinition ^ DataSourceDefinition, System::String ^ UserName, System::String ^ Password, [Runtime::InteropServices::Out] System::String ^ % ConnectError);

[System.Web.Services.Protocols.SoapDocumentMethod("http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/TestConnectForDataSourceDefinition", ParameterStyle=System.Web.Services.Protocols.SoapParameterStyle.Wrapped, RequestNamespace="http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", ResponseNamespace="http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", Use=System.Web.Services.Description.SoapBindingUse.Literal)]
[System.Web.Services.Protocols.SoapHeader("TrustedUserHeaderValue")]
[System.Web.Services.Protocols.SoapHeader("ServerInfoHeaderValue", Direction=System.Web.Services.Protocols.SoapHeaderDirection.Out)]
public bool TestConnectForDataSourceDefinition (ReportService2010.DataSourceDefinition DataSourceDefinition, string UserName, string Password, out string ConnectError);

[<System.Web.Services.Protocols.SoapDocumentMethod("http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/TestConnectForDataSourceDefinition", ParameterStyle=System.Web.Services.Protocols.SoapParameterStyle.Wrapped, RequestNamespace="http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", ResponseNamespace="http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", Use=System.Web.Services.Description.SoapBindingUse.Literal)>]
[<System.Web.Services.Protocols.SoapHeader("TrustedUserHeaderValue")>]
[<System.Web.Services.Protocols.SoapHeader("ServerInfoHeaderValue", Direction=System.Web.Services.Protocols.SoapHeaderDirection.Out)>]
member this.TestConnectForDataSourceDefinition : ReportService2010.DataSourceDefinition * string * string * string -> bool

Public Function TestConnectForDataSourceDefinition (DataSourceDefinition As DataSourceDefinition, UserName As String, Password As String, ByRef ConnectError As String) As Boolean

Parâmetros

DataSourceDefinition: DataSourceDefinition

A definição de fonte de dados que define a conexão à fonte de dados.

UserName: String

O nome do usuário a ser usado para testar a conexão.UserName é usado com fontes de dados que solicitam credenciais.

Password: String

A senha a ser usada para testar a conexão.Password é usado com fontes de dados que solicitam credenciais.

ConnectError: String

Uma mensagem de erro detalhada. A mensagem é retornada quando ocorre uma falha na conexão. O provedor da fonte de dados fornece a mensagem detalhada.

Retornos

Boolean

Um valor booliano indica se a conexão foi concluída com êxito.

Uma cadeia de caracteres que contém uma mensagem de erro detalhada. A cadeia de caracteres é retornada como o parâmetro out ConnectError.

Atributos: SoapDocumentMethodAttribute SoapHeaderAttribute

Comentários

A tabela a seguir mostra o cabeçalho e as informações de permissão sobre esta operação.


Uso do cabeçalho SOAP	(In) TrustedUserHeaderValue (Out) ServerInfoHeaderValue
Permissões necessárias do modo nativo	ExecuteReportDefinition (Sistema)
Permissões necessárias do modo do SharePoint	Precisa da propriedade `EnableLoadReportDefinition` do sistema definida como `true`

A permissão para executar a definição de relatório é necessária.

Aplica-se a