Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

Imaging.Rename - Méthode

Renomme les fichiers spécifiés (éléments) dans une liste sur le site Web en cours.

Espace de noms :  WebSvcImaging
Assembly :  STSSOAP (dans STSSOAP.dll)

[SoapDocumentMethodAttribute("http://schemas.microsoft.com/sharepoint/soap/ois/Rename", RequestNamespace = "http://schemas.microsoft.com/sharepoint/soap/ois/", 
	ResponseNamespace = "http://schemas.microsoft.com/sharepoint/soap/ois/", 
	Use = SoapBindingUse.Literal, ParameterStyle = SoapParameterStyle.Wrapped)]
public XmlNode Rename(
	string strListName,
	string strFolder,
	XmlElement request
)

Paramètres

strListName
Type : System.String

Le nom de la liste dans un site Web en cours.

strFolder
Type : System.String

Le chemin d'accès relatif à la racine de la liste vers le dossier cible.

request
Type : System.Xml.XmlElement

Les fichiers à renommer et le nouveau nom de base. Par exemple, pour renommer "tree.jpg" à « forest.jpg », le paramètre de requête peut ressembler.

Valeur renvoyée

Type : System.Xml.XmlNode
Un objet Microsoft.SharePoint.SoapServer.SoapXml qui contient les éléments suivants.
<results xmlns="http://schemas.microsoft.com/sharepoint/soap/ois/">
  <result name="oldFileName0" renamed="true" 
    newbasename="newBaseName0"/>
  <result name="oldFileName1ThatDoesNotExist" renamed="false"/>
  .
  .
  .
</results>

ExceptionCondition
[0x1]

ListNotFound: la liste demandée n'est pas trouvée.

[0x2]

IsNotLibrary: la liste demandée, bien trouvé, n'est pas une bibliothèque d'images.

[0x3]

ItemNotFound: l'élément demandé est introuvable.

[0x4]

FolderNotFound: le dossier demandé est introuvable.

[0x5]

InvalidArgument: un ou plusieurs arguments ne sont pas valide.

[0x6]

FileExists: le fichier existe déjà, et l'utilisateur ne spécifie pas l'option de remplacement.

L'exemple suivant renomme le fichier image dans la bibliothèque d'images « Mes images » à http://MyServer/sites/mynewsite/MyPictures/1/Red Figure2.gif.

RemarqueRemarque

Ce code suppose que le site et la bibliothèque d'images existent déjà et que vous disposez des autorisations sur le serveur. xmlele est une variable statique qui contient la demande XML pour renommer des éléments.

Web_Reference.Imaging imgws = new Web_Reference.Imaging();
imgws.Credentials = System.Net.CredentialCache.DefaultCredentials;
imgws.Url = "http://MyServer/sites/mynewsite/_vti_bin/imaging.asmx";
System.Xml.XmlDocument resdoc= new System.Xml.XmlDocument();
System.Xml.XmlNode resnode = 
   resdoc.CreateNode(System.Xml.XmlNodeType.Element,"Result","");
resnode = imgws.Rename("My Pictures","1",xmlele);
MessageBox.Show(resnode.ChildNodes[0].InnerText);
Afficher: