ReportingService2005.SetProperties(String, Property[]) 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.

Legt mindestens eine Eigenschaft eines angegebenen Elements fest.

public:
 void SetProperties(System::String ^ Item, cli::array <ReportService2005::Property ^> ^ Properties);

public void SetProperties (string Item, ReportService2005.Property[] Properties);

member this.SetProperties : string * ReportService2005.Property[] -> unit

Public Sub SetProperties (Item As String, Properties As Property())

Parameter

Item: String

Der vollständige Pfadname des Elements.

Properties: Property[]

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

Beispiele

Um das folgende 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 Beschreibung für den Bericht "Unternehmensumsatz" festgelegt:

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 props(0) As [Property]  
      Dim setProp As New [Property]()  
      setProp.Name = "Description"  
      setProp.Value = "Sales by quarter and product category."  
      props(0) = setProp  

      Dim itemPath As String = "/SampleReports/Company Sales"  

      Try  
         rs.SetProperties(itemPath, props)  
         Console.WriteLine("New description set on item {0}.", itemPath)  

      Catch ex As SoapException  
         Console.WriteLine(ex.Detail.OuterXml)  
      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;  

      Property[] props = new Property[1];  
      Property setProp = new Property();  
      setProp.Name = "Description";  
      setProp.Value = "Sales by quarter and product category.";  
      props[0] = setProp;  

      string itemPath = "/SampleReports/Company Sales";   

      try  
      {  
         rs.SetProperties(itemPath, props);  
         Console.WriteLine("New description set on item {0}.", itemPath);  
      }  

      catch (SoapException ex)  
      {  
         Console.WriteLine(ex.Detail.OuterXml);  
      }  
   }  
}

Hinweise

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


SOAP-Header	(In) BatchHeaderValue (Out) ServerInfoHeaderValue
Erforderliche Berechtigungen	Hängt vom Elementtyp ab: - `Folder`: UpdateProperties - `Report`: UpdateProperties - `Resource`: UpdateProperties - `DataSource`: UpdateProperties - `Model`: UpdateProperties

Sie können neue benutzerdefinierte Eigenschaften für ein Element erstellen, indem Sie ein Property Objekt als Methodenargument übergeben. Um eine Eigenschaft aus einem Element zu entfernen, legen Sie die -Eigenschaft auf einen leeren Wert fest. Reservierte Eigenschaften können nicht entfernt werden. Eine Liste der Eigenschaften reservierter Elemente finden Sie unter Eigenschaften von Berichtsserverelementen.

Wenn beim Aufrufen der SetProperties Methode keine angegebene Eigenschaft vorhanden ist, wird die -Eigenschaft erstellt und auf den von Ihnen angegebenen Wert festgelegt. Wenn die Eigenschaft bereits vorhanden ist, wird ihr Wert überschrieben. Das Festlegen eines leeren Werts für eine Eigenschaft, die nicht vorhanden ist, hat keine Auswirkungen auf das Element oder seine Eigenschaften.

Wenn ein Fehler auftritt, werden keine Eigenschaften festgelegt.

Gilt für:

Freigeben über