Compartilhar via


ReportingService2010.TestConnectForItemDataSource Método

Definição

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

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

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