Export (0) Print
Expand All
Expand Minimize
This topic has not yet been rated - Rate this topic

SetSystemProperties Method

SQL Server 2000

ReportingService.SetSystemProperties Method

Sets one or more system properties.

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

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:

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);
      }
   }
}
See Also

ReportingService Class

Reporting Services Web Service Library

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft. All rights reserved.