ReportingService2010.TestConnectForItemDataSource Método

Definição

Namespace:

ReportService2010

Assembly:

ReportService2010.dll

Testa a conexão de uma fonte de dados. Esse método dá suporte aos testes de fontes de dados publicadas usadas por relatórios ou modelos e fontes de dados compartilhadas. Esse método se aplica aos tipos de item Report, Model e Dataset.

public:
 bool TestConnectForItemDataSource(System::String ^ ItemPath, System::String ^ DataSourceName, 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/TestConnectForItemDataSource", 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("ServerInfoHeaderValue", Direction=System.Web.Services.Protocols.SoapHeaderDirection.Out)]
[System.Web.Services.Protocols.SoapHeader("TrustedUserHeaderValue")]
public bool TestConnectForItemDataSource (string ItemPath, string DataSourceName, string UserName, string Password, out string ConnectError);

[<System.Web.Services.Protocols.SoapDocumentMethod("http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/TestConnectForItemDataSource", 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("ServerInfoHeaderValue", Direction=System.Web.Services.Protocols.SoapHeaderDirection.Out)>]
[<System.Web.Services.Protocols.SoapHeader("TrustedUserHeaderValue")>]
member this.TestConnectForItemDataSource : string * string * string * string * string -> bool

Public Function TestConnectForItemDataSource (ItemPath As String, DataSourceName As String, UserName As String, Password As String, ByRef ConnectError As String) As Boolean

Parâmetros

ItemPath

String

A URL totalmente qualificada do item ao qual o DataSourceName se aplica, incluindo o nome do arquivo e, no modo do SharePoint, a extensão. O item pode ser uma fonte de dados compartilhada, um relatório ou um modelo de relatório.

DataSourceName

String

O nome da fonte de dados do item.

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

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

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

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	Depende do tipo de item: - Report, DataSet: ReadDatasource - Report usando um modelo: ReadDatasource no relatório AND ReadDatasource no modelo - Report usando uma fonte de dados compartilhada: ReadDatasource no relatório E ReadContent na fonte de dados compartilhada - DataSource: ReadContent - Model: ReadDatasource
Permissões necessárias do modo do SharePoint	Depende do tipo de item: - Report, DataSet: <xref:Microsoft.SharePoint.SPBasePermissions.OpenItems> ativado ItemPath - Report usando um modelo ou uma fonte de dados compartilhada: <xref:Microsoft.SharePoint.SPBasePermissions.OpenItems> em DataSourceName - DataSource: <xref:Microsoft.SharePoint.SPBasePermissions.OpenItems> - Model: <xref:Microsoft.SharePoint.SPBasePermissions.OpenItems>

Se DataSourceName apontar para uma fonte de dados XML, esse método não fará nada e retornará true.