ReportingService2005.SetProperties 메서드

Sets one or more properties of a specified item.

네임스페이스:  ReportService2005
어셈블리:  ReportService2005(ReportService2005.dll)

public void SetProperties(
	string Item,
	Property[] Properties

매개 변수

유형: System.String
The full path name of the item.
유형: ReportService2005.Property[]
An array of Property objects that defines the properties and values to set for the item.

The table below shows header and permissions information on this operation.

SOAP Headers

(In) BatchHeaderValue

(Out) ServerInfoHeaderValue

Required Permissions

Depends on the item type:

You can create new user-defined properties for an item by passing a Property object as a method argument. To remove a property from an item, set the property to an empty value. You cannot remove reserved properties. For a list of reserved item properties, see 보고서 서버 항목 속성.

If a specified property does not exist when the SetProperties method is called, the property is created and set to the value you supply. If the property already exists, its value is overwritten. Setting an empty value for a property that does not exist has no effect on the item or its properties.

If an error occurs, no properties are set.

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 sets a new description for the Company Sales report:

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"; 

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

      catch (SoapException ex)