ReportingService2005.SetProperties(String, Property[]) Méthode

Référence

Définition

Espace de noms:: ReportService2005

Assembly:: ReportService2005.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Définit une ou plusieurs propriétés d'un élément spécifié.

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())

Paramètres

Item: String

Nom de chemin d'accès complet de l'élément.

Properties: Property[]

Tableau d'objets Property qui définit les propriétés et valeurs à définir pour l'élément.

Exemples

Pour compiler l’exemple de code suivant, vous devez référencer le Reporting Services WSDL et importer certains espaces de noms. Pour plus d’informations, consultez Compilation et exécution d’exemples de code. L’exemple de code suivant définit une nouvelle description pour le rapport Ventes d’entreprise :

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

Remarques

Le tableau suivant présente les informations relatives aux en-têtes et aux autorisations sur cette opération.


En-têtes SOAP	(In) BatchHeaderValue (Out) ServerInfoHeaderValue
Autorisations requises	Dépend du type d’élément : - `Folder`: UpdateProperties - `Report`: UpdateProperties - `Resource`: UpdateProperties - `DataSource`: UpdateProperties - `Model`: UpdateProperties

Vous pouvez créer de nouvelles propriétés définies par l’utilisateur pour un élément en passant un Property objet en tant qu’argument de méthode. Pour supprimer une propriété d’un élément, définissez la propriété sur une valeur vide. Vous ne pouvez pas supprimer les propriétés réservées. Pour obtenir la liste des propriétés d’élément réservées, consultez Propriétés de l’élément du serveur de rapports.

Si une propriété spécifiée n’existe pas lorsque la SetProperties méthode est appelée, la propriété est créée et définie sur la valeur que vous fournissez. Si la propriété existe déjà, sa valeur est remplacée. La définition d’une valeur vide pour une propriété qui n’existe pas n’a aucun effet sur l’élément ou ses propriétés.

Si une erreur se produit, aucune propriété n’est définie.

S’applique à

Partager via