ReportingService2010.TestConnectForItemDataSource Método

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 para uma fonte de dados. Esse método suporta o teste de fontes de dados publicadas que são usadas por relatórios ou modelos e fontes de dados compartilhadas. Esse método se aplica aos Reporttipos , Model, e Dataset item.

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 se aplica, DataSourceName incluindo o nome do arquivo e, no modo 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 de usuário a ser usado para testar a conexão. UserName é usado com fontes de dados que solicitam credenciais.

Password: String

A senha 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 a conexão falha. O fornecedor da fonte de dados fornece a mensagem detalhada.

Retornos

Boolean

Uma string que contém uma mensagem de erro detalhada. A string é retornada como parâmetro out, ConnectError.

Um Booleano indica se a conexão foi concluída com sucesso.

Atributos: SoapDocumentMethodAttribute SoapHeaderAttribute

Comentários

A tabela abaixo mostra informações sobre cabeçalhos e permissões sobre esta operação.


Uso do Cabeçalho SOAP	(Em) TrustedUserHeaderValue (Fora) ServerInfoHeaderValue
Modo Nativo Necessário Permissões	Depende do tipo de item: - `Report`, `DataSet`: ReadDatasource - `Report` usando um modelo: ReadDatasource no relatório E 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 no Modo SharePoint	Depende do tipo de item: - `Report`, `DataSet`: <xref:Microsoft.SharePoint.SPBasePermissions.OpenItems> em `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 faz nada e retorna true.

Aplica-se a