ReportingService2005.SetSystemProperties(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 eine oder mehrere Systemeigenschaften fest.

public:
 void SetSystemProperties(cli::array <ReportService2005::Property ^> ^ Properties);

public void SetSystemProperties (ReportService2005.Property[] Properties);

member this.SetSystemProperties : ReportService2005.Property[] -> unit

Public Sub SetSystemProperties (Properties As Property())

Parameter

Properties: Property[]

Ein Array von Property-Objekten, das die Systemeigenschaften und die Werte definiert, die für einen Berichtsserver festgelegt werden sollen.

Beispiele

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


SOAP-Header	(Out) ServerInfoHeaderValue
Erforderliche Berechtigungen	UpdateSystemProperties (System)

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 Systemeigenschaft namens Description in der Berichtsserver-Datenbank 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 setProp As New [Property]()  
      setProp.Name = "Description"  
      setProp.Value = "My report server that resides on the computer named RSSERVER1."  
      Dim props(0) As [Property]  
      props(0) = setProp  

      Try  
         rs.SetSystemProperties(props)  
         Console.WriteLine("New site property set.")  

      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 setProp = new Property();  
      setProp.Name = "Description";  
      setProp.Value = "My report server that resides on the computer named RSSERVER1.";  
      Property[] props = new Property[1];  
      props[0] = setProp;  

      try  
      {  
         rs.SetSystemProperties( props );  
         Console.WriteLine( "New site property set." );  
      }  

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

Hinweise

Benutzer können zusätzliche benutzerdefinierte Systemeigenschaften hinzufügen, die nicht vom System reserviert sind. Wenn eine im Property Array angegebene Eigenschaft nicht vorhanden ist, wird sie erstellt. Wenn ein Wert für eine Eigenschaft vorhanden ist, wird er überschrieben. Reservierte Systemeigenschaften können nicht erstellt oder entfernt werden. Je nach festgelegter Systemeigenschaft kann sich die Funktionalität des Berichtsservers ändern. Eine Liste der reservierten Systemeigenschaften finden Sie unter Berichtsserver-Systemeigenschaften. Wenn Fehler auftreten, werden keine Eigenschaften festgelegt.

Sie können den Wert einer Eigenschaft entfernen, indem Sie die Eigenschaft auf einen leeren Wert festlegen.

Gilt für:

Freigeben über