Imaging.Rename - Méthode

  • Article

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)

Syntaxe

'Déclaration
<SoapDocumentMethodAttribute("https://schemas.microsoft.com/sharepoint/soap/ois/Rename", RequestNamespace := "https://schemas.microsoft.com/sharepoint/soap/ois/",  _
    ResponseNamespace := "https://schemas.microsoft.com/sharepoint/soap/ois/",  _
    Use := SoapBindingUse.Literal, ParameterStyle := SoapParameterStyle.Wrapped)> _
Public Function Rename ( _
    strListName As String, _
    strFolder As String, _
    request As XmlElement _
) As XmlNode
'Utilisation
Dim instance As Imaging
Dim strListName As String
Dim strFolder As String
Dim request As XmlElement
Dim returnValue As XmlNode

returnValue = instance.Rename(strListName, _
    strFolder, request)

[SoapDocumentMethodAttribute("https://schemas.microsoft.com/sharepoint/soap/ois/Rename", RequestNamespace = "https://schemas.microsoft.com/sharepoint/soap/ois/", 
    ResponseNamespace = "https://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="https://schemas.microsoft.com/sharepoint/soap/ois/">
  <result name="oldFileName0" renamed="true" 
    newbasename="newBaseName0"/>
  <result name="oldFileName1ThatDoesNotExist" renamed="false"/>
  .
  .
  .
</results>

Exceptions

Exception Condition
[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.

Exemples

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

Notes

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.

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

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

Voir aussi

Référence

Imaging classe

Imaging - Membres

WebSvcImaging - Espace de noms