ReportingService2010.TestConnectForItemDataSource 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 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.

Aplica-se a