ReportingService2010.CreateCatalogItem Yöntemi
rapor sunucusu veritabanı veya SharePoint kitaplığı için yeni bir öğe ekler.Bu yöntem uygulandığı raporu, modeli, Dataset, Bileşen, kaynak, ve veri kaynağı öğe türleri.
Ad Alanı: ReportService2010
Derleme: ReportService2010 (ReportService2010 içinde.dll)
Sözdizimi
'Bildirim
<SoapHeaderAttribute("TrustedUserHeaderValue")> _
<SoapDocumentMethodAttribute("https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/CreateCatalogItem", 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)> _
<SoapHeaderAttribute("ServerInfoHeaderValue", Direction := SoapHeaderDirection.Out)> _
Public Function CreateCatalogItem ( _
ItemType As String, _
Name As String, _
Parent As String, _
Overwrite As Boolean, _
Definition As Byte(), _
Properties As Property(), _
<OutAttribute> ByRef Warnings As Warning() _
) As CatalogItem
'Kullanım
Dim instance As ReportingService2010
Dim ItemType As String
Dim Name As String
Dim Parent As String
Dim Overwrite As Boolean
Dim Definition As Byte()
Dim Properties As Property()
Dim Warnings As Warning()
Dim returnValue As CatalogItem
returnValue = instance.CreateCatalogItem(ItemType, _
Name, Parent, Overwrite, Definition, _
Properties, Warnings)
[SoapHeaderAttribute("TrustedUserHeaderValue")]
[SoapDocumentMethodAttribute("https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/CreateCatalogItem", 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)]
[SoapHeaderAttribute("ServerInfoHeaderValue", Direction = SoapHeaderDirection.Out)]
public CatalogItem CreateCatalogItem(
string ItemType,
string Name,
string Parent,
bool Overwrite,
byte[] Definition,
Property[] Properties,
out Warning[] Warnings
)
[SoapHeaderAttribute(L"TrustedUserHeaderValue")]
[SoapDocumentMethodAttribute(L"https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/CreateCatalogItem", 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)]
[SoapHeaderAttribute(L"ServerInfoHeaderValue", Direction = SoapHeaderDirection::Out)]
public:
CatalogItem^ CreateCatalogItem(
String^ ItemType,
String^ Name,
String^ Parent,
bool Overwrite,
array<unsigned char>^ Definition,
array<Property^>^ Properties,
[OutAttribute] array<Warning^>^% Warnings
)
[<SoapHeaderAttribute("TrustedUserHeaderValue")>]
[<SoapDocumentMethodAttribute("https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/CreateCatalogItem", 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)>]
[<SoapHeaderAttribute("ServerInfoHeaderValue", Direction = SoapHeaderDirection.Out)>]
member CreateCatalogItem :
ItemType:string *
Name:string *
Parent:string *
Overwrite:bool *
Definition:byte[] *
Properties:Property[] *
Warnings:Warning[] byref -> CatalogItem
public function CreateCatalogItem(
ItemType : String,
Name : String,
Parent : String,
Overwrite : boolean,
Definition : byte[],
Properties : Property[],
Warnings : Warning[]
) : CatalogItem
Parametreler
- ItemType
Tür: System.String
öğe türü.
- Name
Tür: System.String
Yeni adı öğe, SharePoint modunda dosya uzantısıyla birlikte.
- Parent
Tür: System.String
öğe içeren üst klasörün tam URL'si.
- Overwrite
Tür: System.Boolean
A Boole belirtilen konumda aynı ada sahip varolan öğe üzerine gösteren ifade.
- Definition
Tür: array<System.Byte[]
.Rdl Rapor tanımı, rapor modeli tanımı veya rapor sunucusu yayımlamak için kaynak içeriği.
- Properties
Tür: array<ReportService2010.Property[]
Bir dizi Property içeren özellik adları ve değerleri için nesneleri küme öğe.
- Warnings
Tür: array<ReportService2010.Warning[]%
[Çıkış] Bir dizi Warning öğe doğrulandı sırasında oluştu uyarılar açıklayan nesnelerinin.
Dönüş Değeri
Tür: ReportService2010.CatalogItem
A CatalogItem nesne için yeni oluşturulan öğe.
Açıklamalar
Aşağıdaki tablo üstbilgi ve izinler bu işlemi gösterir.
soap üstbilgisi kullanımı |
(Giden)ServerInfoHeaderValue |
Yerel mod gerekli izinleri |
Öğe türüne bağlıdır:
|
SharePoint modu gerekli izinleri |
Öğe türüne bağlıdır:
|
Bu yöntem, tüm desteklenen öğe türlerinin öğeler oluşturabilirsiniz.Hangi öğe türlerinin desteklendiğini görmek için ListItemTypes yöntem.
Modeli öğe türü yazılamıyor.Bu nedenle, Overwrite parametresi olmalıdır yanlış , ItemType olan modeli.Aksi halde, bir rsInvalidParameterCombination exception Is thrown.
ItemType Olan raporu, sonra da xml verileri tarafından tanımlanan Report Definition Language.ItemType Olan modeli, sonra da xml verileri tarafından tanımlanan Semantic Model Definition Language.
Hatalar oluşursa, öğe oluşturulmaz.
rapor sunucusu veritabanı veya SharePoint kitaplığı bir öğe ekleyerek değiştirir ModifiedBy ve ModifiedDate özelliklerinin üst klasör.
öğe adı geçerli bir dosya adı uzantısını (örneğin, .rdl) dışlanırsa, bir rsFileExtensionRequired hata döndürülür.
Uzunluğu Parent parametresi; 260 karakteri aşamaz Aksi takdirde hata koduyla bir soap özel durum rsItemLengthExceeded.
Parent Parametresi null veya boş veya aşağıdaki ayrılmış karakterleri içeremez: : ? ; @ & = + $ , \ * > < | . ".Öğeler klasörünün tam yol adını ayırmak için eğik çizgi (/) karakter kullanabilirsiniz, ancak klasör adının sonuna kullanamazsınız.
Örnekler
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;
Byte[] definition = null;
Warning[] warnings = null;
string name = "MyReport.rdl";
try
{
FileStream stream = File.OpenRead("MyReport.rdl");
definition = new Byte[stream.Length];
stream.Read(definition, 0, (int)stream.Length);
stream.Close();
}
catch (IOException e)
{
Console.WriteLine(e.Message);
}
try
{
string parent = "http://<Server Name>/Docs/Documents/";
CatalogItem report = rs.CreateCatalogItem("Report", name, parent,
false, definition, null, out warnings);
if (warnings != null)
{
foreach (Warning warning in warnings)
{
Console.WriteLine(warning.Message);
}
}
else
Console.WriteLine("Report: {0} created successfully " +
" with no warnings", name);
}
catch (SoapException e)
{
Console.WriteLine(e.Detail.InnerXml.ToString());
}
}
}
Imports System
Imports System.IO
Imports System.Text
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 definition As [Byte]() = Nothing
Dim warnings As Warning() = Nothing
Dim name As String = "MyReport.rdl"
Try
Dim stream As FileStream = File.OpenRead("MyReport.rdl")
definition = New [Byte](stream.Length - 1) {}
stream.Read(definition, 0, CInt(stream.Length))
stream.Close()
Catch e As IOException
Console.WriteLine(e.Message)
End Try
Try
Dim parentPath As String = _
"http://<Server Name>/Docs/Documents/"
rs.CreateCatalogItem("Report", name, parentPath, False, _
definition, Nothing, warnings)
If Not (warnings Is Nothing) Then
Dim warning As Warning
For Each warning In warnings
Console.WriteLine(warning.Message)
Next warning
Else
Console.WriteLine("Report: {0} created " + _
"successfully with no warnings", name)
End If
Catch e As SoapException
Console.WriteLine(e.Detail.InnerXml.ToString())
End Try
End Sub
End Class