ReportingService2006.CreateDataSource(String, String, Boolean, DataSourceDefinition, Property[]) ReportingService2006.CreateDataSource(String, String, Boolean, DataSourceDefinition, Property[]) ReportingService2006.CreateDataSource(String, String, Boolean, DataSourceDefinition, Property[]) Method

定义

在 SharePoint 库中创建新的数据源。 Creates a new data source in a SharePoint library.

public:
 ReportService2006::CatalogItem ^ CreateDataSource(System::String ^ DataSource, System::String ^ Parent, bool Overwrite, ReportService2006::DataSourceDefinition ^ Definition, cli::array <ReportService2006::Property ^> ^ Properties);
public ReportService2006.CatalogItem CreateDataSource (string DataSource, string Parent, bool Overwrite, ReportService2006.DataSourceDefinition Definition, ReportService2006.Property[] Properties);
Public Function CreateDataSource (DataSource As String, Parent As String, Overwrite As Boolean, Definition As DataSourceDefinition, Properties As Property()) As CatalogItem

参数

DataSource
String String String

数据源的名称,其中包括文件名和文件扩展名 (.rsds)。 The name for the data source including the file name and extension (.rsds).

Parent
String String String

将包含数据源的父文件夹的完全限定 URL。 The fully qualified URL for the parent folder that will contain the data source.

Overwrite
Boolean Boolean Boolean

一个Boolean表达式,它指示是否应该覆盖指定的位置中同名的现有数据源。 A Boolean expression that indicates whether an existing data source with the same name in the location specified should be overwritten.

Definition
DataSourceDefinition DataSourceDefinition DataSourceDefinition

一个DataSourceDefinition描述数据源的连接属性对象。 A DataSourceDefinition object that describes the connection properties for the data source.

Properties
Property[]

一个数组Property定义的属性名称和值设置为数据源的对象。 An array of Property objects that defines the property names and values to set for the data source.

返回

一个CatalogItem新创建的数据源对象。 A CatalogItem object for the newly created data source.

示例

using System;  
using System.Collections.Generic;  
using System.IO;  
using System.Text;  
using System.Web;  
using System.Web.Services;  
using System.Web.Services.Protocols;  
  
class Sample  
{  
    static void Main(string[] args)  
    {  
        ReportingService2006 rs = new ReportingService2006();  
        rs.Url = "http://<Server Name>" +   
            "/_vti_bin/ReportServer/ReportService2006.asmx";  
        rs.Credentials =   
            System.Net.CredentialCache.DefaultCredentials;  
  
        string name = "AdventureWorks.rsds";  
        string parent = "http://<Server Name>/Docs/Documents/";  
  
        // Define the data source definition.  
        DataSourceDefinition definition = new DataSourceDefinition();  
        definition.CredentialRetrieval =   
            CredentialRetrievalEnum.Integrated;  
        definition.ConnectString =   
            "data source=(local);initial catalog=AdventureWorks";  
        definition.Enabled = true;  
        definition.EnabledSpecified = true;  
        definition.Extension = "SQL";  
        definition.ImpersonateUserSpecified = false;  
        //Use the default prompt string.  
        definition.Prompt = null;  
        definition.WindowsCredentials = false;  
  
        try  
        {  
            rs.CreateDataSource(name, parent, false,   
                definition, null);  
        }  
        catch (SoapException e)  
        {  
            Console.WriteLine(e.Detail.InnerXml.ToString());  
        }  
    }  
}  
Imports System  
Imports System.Web.Services  
Imports System.Web.Services.Protocols  
  
Class Sample  
  
    Public Shared Sub Main()  
  
        Dim rs As New ReportingService2006()  
        rs.Url = "http://<Server Name>" + _  
            "/_vti_bin/ReportServer/ReportService2006.asmx"  
        rs.Credentials = _  
            System.Net.CredentialCache.DefaultCredentials  
  
        Dim name As String = "AdventureWorks.rsds"  
        Dim parent As String = "http://<Server Name>/Docs/Documents/"  
  
        ' Define the data source definition.  
        Dim definition As New DataSourceDefinition()  
        definition.CredentialRetrieval = _  
            CredentialRetrievalEnum.Integrated  
        definition.ConnectString = _  
            "data source=(local);initial catalog=AdventureWorks"  
        definition.Enabled = True  
        definition.EnabledSpecified = True  
        definition.Extension = "SQL"  
        definition.ImpersonateUserSpecified = False  
        'Use the default prompt string.  
        definition.Prompt = Nothing  
        definition.WindowsCredentials = False  
  
        Try  
            rs.CreateDataSource(name, parent, False, _  
                definition, Nothing)  
        Catch e As SoapException  
            Console.WriteLine(e.Detail.InnerXml.ToString())  
        End Try  
  
    End Sub  
  
End Class  

注解

下表显示了有关此操作的标头和权限信息。The table below shows header and permissions information on this operation.

SOAP 标头SOAP Headers (In) TrustedUserHeaderValue(In) TrustedUserHeaderValue

(Out) ServerInfoHeaderValue(Out) ServerInfoHeaderValue
所需的权限Required Permissions 创建新的数据源:AddListItemsParentCreating a new data source: AddListItems on Parent

更新现有数据源:EditListItemsDataSourceUpdating an existing data source: EditListItems on DataSource

如果从数据源名称,排除.rsds 扩展rsFileExtensionRequired将返回错误。If the .rsds extension is excluded from the data source name, an rsFileExtensionRequired error will be returned. 如果未指定.odc 扩展,rsNotSupported返回错误。If an .odc extension is given, an rsNotSupported error is returned.

如果出现错误,不会创建数据源。If errors occur, the data source is not created.

长度Parent参数不能超过 260 个字符; 否则,并提供错误代码引发 SOAP 异常rsItemLengthExceededThe length of the Parent parameter cannot exceed 260 characters; otherwise, a SOAP exception is thrown with the error code rsItemLengthExceeded.

Parent参数不能为 null 或为空或包含下列保留的字符: : ? ; @ & = + $ , \ * > < | . "The Parent parameter cannot be null or empty or contain the following reserved characters: : ? ; @ & = + $ , \ * > < | . ". 可以使用正斜杠字符 (/) 分隔的文件夹的完整路径名称中的项,但不能在文件夹名称末尾使用You can use the forward slash character (/) to separate items in the full path name of the folder, but you cannot use it at the end of the folder name

适用于