SPFileCollection.Item - Propriété (String)

Obtient l'objet fichier avec l'URL spécifiée à partir de la collection. Dans Microsoft Visual C#, cette propriété est un indexeur pour la classe SPFileCollection .

Espace de noms :  Microsoft.SharePoint
Assembly :  Microsoft.SharePoint (dans Microsoft.SharePoint.dll)

Syntaxe

'Déclaration
Public ReadOnly Default Property Item ( _
    urlOfFile As String _
) As SPFile
    Get
'Utilisation
Dim instance As SPFileCollection
Dim urlOfFile As String
Dim value As SPFile

value = instance(urlOfFile)
public SPFile this[
    string urlOfFile
] { get; }

Paramètres

  • urlOfFile
    Type : System.String

    L'URL relative au site du fichier.

Valeur de propriété

Type : Microsoft.SharePoint.SPFile
Objet SPFile qui représente le fichier.

Exemples

L'exemple de code suivant utilise l'indexeur pour renvoyer un objet de fichier spécifié et afficher le titre du fichier, lors de la dernière modification du fichier et le nom de l'utilisateur qui a modifié le fichier.

Cet exemple requiert les directives using (Imports dans Visual Basic) pour les espaces de noms Microsoft.SharePoint et Microsoft.SharePoint.Utilities .

L'exemple suppose également l'existence d'une page .aspx qui contient un contrôle label.

Dim webSite As SPWeb = SPContext.Current.Web
Try
    Dim srcFile As SPFile = webSite.GetFolder("MyDocLib").Files("MyFile")

    Label1.Text = SPEncode.HtmlEncode(srcFile.Title) + " :: " + srcFile.TimeLastModified + " :: " + srcFile.ModifiedBy.Name
Finally
    webSite.Dispose()
End Try
SPWeb oWebsite = SPContext.Current.Web;
SPFile oFile = oWebsite.GetFolder("MyDocLib").Files["MyFile"];

Label1.Text = SPEncode.HtmlEncode(oFile.Title) + " :: " + 
    oFile.TimeLastModified + " :: " + oFile.ModifiedBy.Name;

L'exemple de code suivant utilise l'indexeur pour copier un fichier à partir d'une bibliothèque de documents dans un site vers une bibliothèque de documents dans un autre site.

Dim siteCollection As New SPSite("http://MySiteCollection")
Try
    Dim destFiles As SPFileCollection = siteCollection.AllWebs("DestinWebSite").GetFolder("DestinDocLib").Files
    Dim srcFile As SPFile = siteCollection.AllWebs("SourceWebSite").GetFolder("SourceDocLib").Files("MyFile")

    Dim copyFile As Byte() = srcFile.OpenBinary()
        destFiles.Add(srcFile.Title, copyFile)
Finally
    srcSiteCollection.Dispose()
End Try
using (SPSite oSiteCollection = new SPSite("https://localhost"))
{
    SPFileCollection collFiles = oSiteCollection.AllWebs["DestWebSite"].GetFolder("DestDocLib").Files;
    SPFile oFile = siteCollection.AllWebs["SourceWebSite"].GetFolder("SourceDocLib").Files["MyFile"];
    byte[] binCopyFile = oFile.OpenBinary();
    collFiles.Add(oFile.Title, strCopyFile);
}

Notes

Certains objets implémentent l'interface IDisposable , et vous devez éviter de conserver ces objets dans la mémoire après que qu'ils ne sont plus nécessaires. Pour plus d'informations sur les bonnes pratiques de codage, consultez Disposing Objects.

Voir aussi

Référence

SPFileCollection classe

SPFileCollection - Membres

Item - Surcharge

Microsoft.SharePoint - Espace de noms