ReportingService.SetSystemProperties Method

Sets one or more system properties.

Visual Basic

Public Sub SetSystemProperties( _
   ByVal Properties As String _
)
   Member of [Namespace].ReportingService

public void SetSystemProperties(
   string Properties
);
   Member of [Namespace].ReportingService

Parameters

Properties: An array of Property[] objects that defines the system properties and values to set for a report server.

Permissions

Operation	Description
Update System Properties	Required to modify system-level properties.

Remarks

Users can add additional custom system properties that are not reserved by the system. If a property specified in the Property[] array does not exist, it is created. If a value for a property exists, it is overwritten. You cannot create or remove reserved system properties. Depending on the system property being set, the functionality of the report server may change. For a list of reserved system properties, see Report Server System Properties. If errors occur, no properties are set.

You can remove the value of a property by setting the property to an empty value.

Example

Visual Basic, C#

To compile the following code example, you must reference the Reporting Services WSDL and import certain namespaces. For more information, see Compiling and Running Code Examples. The following code example creates a new system property named Description in the report server database:

Visual Basic

Imports System
Imports System.Web.Services.Protocols

Class Sample
   Public Shared Sub Main()
      Dim rs As New ReportingService()
      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()
   {
      ReportingService rs = new ReportingService();
      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);
      }
   }
}