ReportingService2005.CreateDataSource Methode

Referenz

Definition

Namespace:: ReportService2005

Assembly:: ReportService2005.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Erstellt eine neue Datenquelle in der Berichtsserver-Datenbank.

public:
 void CreateDataSource(System::String ^ DataSource, System::String ^ Parent, bool Overwrite, ReportService2005::DataSourceDefinition ^ Definition, cli::array <ReportService2005::Property ^> ^ Properties);

public void CreateDataSource (string DataSource, string Parent, bool Overwrite, ReportService2005.DataSourceDefinition Definition, ReportService2005.Property[] Properties);

member this.CreateDataSource : string * string * bool * ReportService2005.DataSourceDefinition * ReportService2005.Property[] -> unit

Public Sub CreateDataSource (DataSource As String, Parent As String, Overwrite As Boolean, Definition As DataSourceDefinition, Properties As Property())

Parameter

DataSource: String

Den Namen der Datenquelle.

Parent: String

Der vollständige Pfadname des übergeordneten Ordners mit der Datenquelle.

Overwrite: Boolean

Ein Boolean-Ausdruck, der angibt, ob eine vorhandene Datenquelle mit dem gleichen Namen am angegebenen Speicherort überschrieben werden soll.

Definition: DataSourceDefinition

Ein DataSourceDefinition-Objekt, das die Verbindungseigenschaften für die Datenquelle beschreibt.

Properties: Property[]

Ein Array von Property-Objekten, das die Eigenschaftennamen und die Werte definiert, die für die Datenquelle festgelegt werden sollen.

Beispiele

Um dieses Codebeispiel zu kompilieren, müssen Sie auf die Reporting Services WSDL verweisen und bestimmte Namespaces importieren. Weitere Informationen finden Sie unter Kompilieren und Ausführen von Codebeispielen. Im folgenden Codebeispiel wird eine neue Datenquelle im Stammordner der Berichtsserverdatenbank erstellt:

Imports System  
Imports System.Web.Services.Protocols  

Class Sample  
   Public Shared Sub Main()  
      Dim rs As New ReportingService2005()  
      rs.Credentials = System.Net.CredentialCache.DefaultCredentials  

      Dim name As String = "AdventureWorks"  
      Dim parent As String = "/"  

      ' 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 'Main  
End Class 'Sample

using System;  
using System.Web.Services.Protocols;  

class Sample  
{  
   public static void Main()  
   {  
      ReportingService2005 rs = new ReportingService2005();  
      rs.Credentials = System.Net.CredentialCache.DefaultCredentials;  

      string name = "AdventureWorks";  
      string parent ="/";  

      // 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());   
      }  
   }  
}

Hinweise

In der folgenden Tabelle werden Header- und Berechtigungsinformationen zu diesem Vorgang dargestellt.


SOAP-Header	(In) BatchHeaderValue (Out) ServerInfoHeaderValue
Erforderliche Berechtigungen	Erstellen einer neuen Datenquelle: CreateDatasource on `Parent` Aktualisieren einer vorhandenen Datenquelle: UpdateContent on `DataSource` Aktualisieren von Datenquelleneigenschaften: UpdateContent AND UpdateProperties on `DataSource`

Wenn Fehler auftreten, wird die Datenquelle nicht erstellt.

Die Länge des Parent Parameters darf 260 Zeichen nicht überschreiten. Andernfalls wird eine SOAP-Ausnahme mit dem Fehlercode rsItemLengthExceeded ausgelöst.

Der Parent Parameter darf nicht NULL oder leer sein oder die folgenden reservierten Zeichen enthalten: : ? ; @ & = + $ , \ * > < | . ". Sie können den Schrägstrich (/) verwenden, um Elemente im vollständigen Pfadnamen des Ordners zu trennen, aber sie können es nicht am Ende des Ordnernamens verwenden.

Gilt für:

Freigeben über