Imaging.Download - Méthode

  • Article

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)

Syntaxe

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

returnValue = instance.Download(strListName, _
    strFolder, itemFileNames, type, fFetchOriginalIfNotAvailable)

[SoapDocumentMethodAttribute("https://schemas.microsoft.com/sharepoint/soap/ois/Download", RequestNamespace = "https://schemas.microsoft.com/sharepoint/soap/ois/", 
    ResponseNamespace = "https://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="https://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>

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 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.

Notes

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.

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", "")
Dim a(0) As String
a(0) = "Red Figure2.gif"
resnode = imgws.Download("My Pictures", "1", a, 0, True)
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","");
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.

Notes

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.

Dim adminws As 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 ex As Exception
        MessageBox.Show(ex.Message)
End Try

Dim listsws As 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 ex1 As Exception
        MessageBox.Show(ex1.Message)
End Try

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", "")
Dim b As [Byte]() = System.Text.Encoding.Unicode.GetBytes
    ("R0lGODlhCQALAJEAAAoLBv///wAAAP///
    yH5BAEAAAMALAAAAAAJAAsAAAIdlIdmETDAxBAxosm
    CvE9fNU0K40Ae1ZBftq0t9xYAOw==")
imgws.Upload("My Pictures", "1", b, "Red Figure2.gif", True)
MessageBox.Show("Picture uploaded")
Dim a(0) As String
a(0) = "Red Figure1.gif"
resnode = imgws.Download("My Pictures", "1", a, 0, True)
MessageBox.Show(resnode.ChildNodes(0).InnerText)

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

Voir aussi

Référence

Imaging classe

Imaging - Membres

WebSvcImaging - Espace de noms