ReportingService2005.SetProperties(String, Property[]) Méthode
Définition
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
Le nom complet du chemin de l’objet.
- Properties
- Property[]
Un 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 WSDL de Reporting Services et importer certains espaces de noms. Pour plus d’informations, voir Exemples de compilation et exécution de code. L’exemple de code suivant établit une nouvelle description pour le rapport de ventes de l’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 ci-dessous présente les informations sur l’en-tête et les autorisations concernant cette opération.
| En-têtes SOAP | (En) BatchHeaderValue (Dehors) ServerInfoHeaderValue |
| Autorisations requises | Cela dépend du type d’objet : - 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 comme argument de méthode. Pour retirer une propriété d’un élément, fixez la propriété à une valeur vide. Vous ne pouvez pas supprimer les propriétés réservées. Pour une liste des propriétés réservées des objets, voir Propriétés des éléments du serveur de rapport.
Si une propriété spécifiée n’existe pas au moment de l’appel de la SetProperties méthode, la propriété est créée et fixée à la valeur que vous fournissez. Si la propriété existe déjà, sa valeur est écrasée. Définir une valeur vide pour une propriété qui n’existe pas n’a aucun effet sur l’objet ni sur ses propriétés.
En cas d’erreur, aucune propriété n’est définie.