ReportingService2005.CreateDataSource Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Crée une source de données dans la base de données du serveur de rapports.
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())
Paramètres
- DataSource
- String
Nom de la source de données.
- Parent
- String
Nom de chemin d'accès complet du dossier parent qui contient la source de données.
- Overwrite
- Boolean
Expression Boolean
qui indique si une source de données existante portant le même nom dans l'emplacement spécifié doit être remplacée.
- Definition
- DataSourceDefinition
Objet DataSourceDefinition qui décrit les propriétés de connexion de la source de données.
- Properties
- Property[]
Tableau d'objets Property qui définit les noms et valeurs des propriétés à définir pour la source de données.
Exemples
Pour compiler cet exemple de code, vous devez référencer le Reporting Services WSDL et importer certains espaces de noms. Pour plus d’informations, consultez Compilation et exécution d’exemples de code. L’exemple de code suivant crée une source de données dans le dossier racine de la base de données du serveur de rapports :
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());
}
}
}
Remarques
Le tableau suivant présente les informations relatives aux en-têtes et aux autorisations sur cette opération.
En-têtes SOAP | (In) BatchHeaderValue (Out) ServerInfoHeaderValue |
Autorisations requises | Création d’une source de données : CreateDatasource activé Parent Mise à jour d’une source de données existante : UpdateContent sur DataSource Mise à jour des propriétés de la source de données : UpdateContent AND UpdateProperties sur DataSource |
Si des erreurs se produisent, la source de données n’est pas créée.
La longueur du Parent
paramètre ne peut pas dépasser 260 caractères ; sinon, une exception SOAP est levée avec le code d’erreur rsItemLengthExceeded.
Le Parent
paramètre ne peut pas être null ou vide ou contenir les caractères réservés suivants : : ? ; @ & = + $ , \ * > < | . "
. Vous pouvez utiliser la barre oblique (/) pour séparer les éléments dans le nom de chemin d’accès complet du dossier, mais vous ne pouvez pas l’utiliser à la fin du nom du dossier