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.Download - Méthode

Télécharge 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/Download", RequestNamespace = "http://schemas.microsoft.com/sharepoint/soap/ois/", 
	ResponseNamespace = "http://schemas.microsoft.com/sharepoint/soap/ois/", 
	Use = SoapBindingUse.Literal, ParameterStyle = SoapParameterStyle.Wrapped)]
public XmlNode Download(
	string strListName,
	string strFolder,
	string[] itemFileNames,
	uint type,
	bool fFetchOriginalIfNotAvailable
)

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.

itemFileNames
Type : []

Tableau des noms de fichiers (éléments) à télécharger.

type
Type : System.UInt32

La version des fichiers à télécharger. Valeurs valides : 0 d'origine, 1 de miniature, 2 d'image Web.

fFetchOriginalIfNotAvailable
Type : System.Boolean

Si ce paramètre est défini sur true et la version demandée n'est pas disponible pour une raison quelconque, la version d'origine est extrait.

Valeur renvoyée

Type : System.Xml.XmlNode
Un objet System.Xml.XmlDocument qui contient les éléments suivants.
<Files xmlns="http://schemas.microsoft.com/sharepoint/soap/ois/">
  <File name="itemFileNames[0]" found="false"/>
  <File name="itemFileNames[1]" lastmodified="…">
    Base64 encoded bytes of the file content
  </File>
  <File name="itemFileNames[2]" lastmodified="…" 
        originalDownloaded="true">
    Base64 encoded bytes of the file content
  </File>
  .
  .
  .
</Files>

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 télécharge le fichier d'image à partir de la bibliothèque d'images « Mes images »: http://MyServer/sites/mynewsite/MyPictures/1/Red Figure2.gif.

RemarqueRemarque

Ce code suppose que la bibliothèque du site et l'image existe déjà et que vous disposez des autorisations sur le serveur. Si le site et la bibliothèque d'images n'existent pas, consultez le deuxième exemple.

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","");
String[] a = new String[1];
a[0]="Red Figure2.gif";
resnode = imgws.Download("My Pictures","1",a,0,true);
MessageBox.Show(resnode.ChildNodes[0].InnerText);

Cet exemple montre comment créer le site et image à la bibliothèque et ajouter l'image « Red Figure2.gif » requis dans l'exemple précédent.

RemarqueRemarque

Vous devez être membre du groupe de sites Administrateurs sur le serveur Microsoft Windows SharePoint Services pour ajouter une référence pour le service Web Admin et d'exécuter les actions requises.

Web_Reference.Admin adminws = new Web_Reference.Admin();
adminws.Credentials= System.Net.CredentialCache.DefaultCredentials;
try
{
   adminws.CreateSite("http://MyServer/sites/my2003site",
      "My 2003 New Site","Manage content and pictures for year 
      2003",1033,"MPS#0","User_Alias","Display_Name",
      "someone@example.com","","");
}
catch(Exception ex)
{
   MessageBox.Show(ex.Message);
}
Web_Reference.Lists listsws = new Web_Reference.Lists();
listsws.Credentials = System.Net.CredentialCache.DefaultCredentials;
listsws.Url = "http://MyServer/sites/mynewsite/_vti_bin/lists.asmx";
try
{
   listsws.AddList("My Pictures","My personal pictures",109);
}
catch(Exception ex1)
{
   MessageBox.Show(ex1.Message);
}
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","");
Byte[] b =System.Text.Encoding.Unicode.GetBytes
   ("R0lGODlhCQALAJEAAAoLBv///wAAAP///
   yH5BAEAAAMALAAAAAAJAAsAAAIdlIdmETDAxBAxosm
   CvE9fNU0K40Ae1ZBftq0t9xYAOw==");
imgws.Upload("My Pictures","1",b,"Red Figure2.gif", true);
MessageBox.Show("Picture uploaded");
String[] a = new String[1];
a[0]="Red Figure1.gif";
resnode = imgws.Download("My Pictures","1",a,0,true);
MessageBox.Show(resnode.ChildNodes[0].InnerText);
Afficher: