Metoda ReportingService2010.CreateDataSource
Tworzy nowe źródło danych w baza danych serwer raportów lub w bibliotece programu SharePoint.
Przestrzeń nazw: ReportService2010
Zestaw: ReportService2010 (w ReportService2010.dll)
Składnia
'Deklaracja
<SoapHeaderAttribute("TrustedUserHeaderValue")> _
<SoapHeaderAttribute("ServerInfoHeaderValue", Direction := SoapHeaderDirection.Out)> _
<SoapDocumentMethodAttribute("https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/CreateDataSource", RequestNamespace := "https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", _
ResponseNamespace := "https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", _
Use := SoapBindingUse.Literal, ParameterStyle := SoapParameterStyle.Wrapped)> _
Public Function CreateDataSource ( _
DataSource As String, _
Parent As String, _
Overwrite As Boolean, _
Definition As DataSourceDefinition, _
Properties As Property() _
) As CatalogItem
'Użycie
Dim instance As ReportingService2010
Dim DataSource As String
Dim Parent As String
Dim Overwrite As Boolean
Dim Definition As DataSourceDefinition
Dim Properties As Property()
Dim returnValue As CatalogItem
returnValue = instance.CreateDataSource(DataSource, _
Parent, Overwrite, Definition, Properties)
[SoapHeaderAttribute("TrustedUserHeaderValue")]
[SoapHeaderAttribute("ServerInfoHeaderValue", Direction = SoapHeaderDirection.Out)]
[SoapDocumentMethodAttribute("https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/CreateDataSource", RequestNamespace = "https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer",
ResponseNamespace = "https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer",
Use = SoapBindingUse.Literal, ParameterStyle = SoapParameterStyle.Wrapped)]
public CatalogItem CreateDataSource(
string DataSource,
string Parent,
bool Overwrite,
DataSourceDefinition Definition,
Property[] Properties
)
[SoapHeaderAttribute(L"TrustedUserHeaderValue")]
[SoapHeaderAttribute(L"ServerInfoHeaderValue", Direction = SoapHeaderDirection::Out)]
[SoapDocumentMethodAttribute(L"https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/CreateDataSource", RequestNamespace = L"https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer",
ResponseNamespace = L"https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer",
Use = SoapBindingUse::Literal, ParameterStyle = SoapParameterStyle::Wrapped)]
public:
CatalogItem^ CreateDataSource(
String^ DataSource,
String^ Parent,
bool Overwrite,
DataSourceDefinition^ Definition,
array<Property^>^ Properties
)
[<SoapHeaderAttribute("TrustedUserHeaderValue")>]
[<SoapHeaderAttribute("ServerInfoHeaderValue", Direction = SoapHeaderDirection.Out)>]
[<SoapDocumentMethodAttribute("https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/CreateDataSource", RequestNamespace = "https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer",
ResponseNamespace = "https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer",
Use = SoapBindingUse.Literal, ParameterStyle = SoapParameterStyle.Wrapped)>]
member CreateDataSource :
DataSource:string *
Parent:string *
Overwrite:bool *
Definition:DataSourceDefinition *
Properties:Property[] -> CatalogItem
public function CreateDataSource(
DataSource : String,
Parent : String,
Overwrite : boolean,
Definition : DataSourceDefinition,
Properties : Property[]
) : CatalogItem
Parametry
- DataSource
Typ: System.String
Nazwa źródło danych, łącznie z nazwą pliku i w trybie SharePoint rozszerzenie (.rsds).
- Parent
Typ: System.String
Pełni kwalifikowany adres URL dla folderu nadrzędnego zawierające źródło danych.
- Overwrite
Typ: System.Boolean
A wartość logiczna wyrażenie, która wskazuje, czy można zastąpić istniejącego źródło danych o tej samej nazwie w określonej lokalizacji.
- Definition
Typ: ReportService2010.DataSourceDefinition
A DataSourceDefinition obiekt, który opisuje właściwości połączenia dla źródło danych.
- Properties
Typ: array<ReportService2010.Property[]
Tablica Property obiektów, które definiuje nazw właściwość i wartości do zestaw dla źródło danych.
Wartość zwracana
Typ: ReportService2010.CatalogItem
A CatalogItem obiektu dla nowo utworzonych danych źródło.
Uwagi
W poniższej tabela przedstawiono informacje nagłówka i uprawnienia na tej operacji.
Użycie nagłówek protokołu SOAP |
(Ruch wychodzący)ServerInfoHeaderValue |
Tryb macierzysty wymagane uprawnienia |
Tworzenie nowego źródło danych: CreateDatasource na Parent Aktualizowanie istniejącego źródło danych: UpdateContent na DataSource Aktualizowanie właściwości źródło danych: UpdateContentAND UpdateProperties on DataSource |
Tryb programu SharePoint wymagane uprawnienia |
Tworzenie nowego źródło danych: AddListItems() na Parent Aktualizowanie istniejącego źródło danych: EditListItems() na DataSource |
Jeśli .rsds rozszerzenia są wyłączone z nazwy źródło danych rsFileExtensionRequired zostanie zwrócony błąd.Jeśli podano rozszerzeniem odc rsNotSupported zwracany jest błąd.
Jeśli wystąpią błędy, źródło danych nie jest tworzony.
Długość Parent parametr nie może przekraczać 260 znaków; w przeciwnym razie SOAP jest wyjątek z kodem błędu rsItemLengthExceeded.
Parent Parametr nie może być null lub puste lub zawierać następujących znaków zarezerwowanych: : ? ; @ & = + $ , \ * > < | . ".Ukośnik (/) można używać do oddzielania elementów pełną nazwę ścieżka folderu, ale nie można go użyć na końcu nazwy folderu.
Przykłady
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)
{
ReportingService2010 rs = new ReportingService2010();
rs.Url = "http://<Server Name>" +
"/_vti_bin/ReportServer/ReportService2010.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 ReportingService2010()
rs.Url = "http://<Server Name>" + _
"/_vti_bin/ReportServer/ReportService2010.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