HttpFileCollection Sınıf

Tanım

Ad Alanı:: System.Web

Bütünleştirilmiş Kod:: System.Web.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

İstemci tarafından karşıya yüklenen dosyalara erişim sağlar ve dosyaları düzenler.

public ref class HttpFileCollection sealed : System::Collections::Specialized::NameObjectCollectionBase

public sealed class HttpFileCollection : System.Collections.Specialized.NameObjectCollectionBase

type HttpFileCollection = class
    inherit NameObjectCollectionBase

Public NotInheritable Class HttpFileCollection
Inherits NameObjectCollectionBase

Devralma: Object

NameObjectCollectionBase
HttpFileCollection

Örnekler

Aşağıdaki örnekte, nesnesinin HttpFileCollection özelliğinden döndürülen koleksiyona Files nasıl erişülecek HttpRequest gösterilmektedir. Koleksiyon HttpFileCollection , Web sayfasındaki iki FileUpload denetimle doldurulur. Dosya koleksiyonundaki öğeler bir BulletedList denetimde görüntülenir.

<%@ Page Language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

    protected void Button1_Click(object sender, EventArgs e)
    {
        // Clear the BulletedList.
        BulletedList1.Items.Clear();
        
        // Check to see if at least one file was specified.
        if (FileUpload1.HasFile | FileUpload2.HasFile)
        {
            Label1.Text = "The file collection consists of:";
            
            // Get the HttpFileCollection.
            HttpFileCollection hfc = Request.Files;
            foreach (String h in hfc.AllKeys)
            {
                // Add an item to the BulletedList if a file
                // was specified for the corresponding control.
                if (hfc[h].ContentLength > 0)
                    BulletedList1.Items.Add(Server.HtmlEncode(hfc[h].FileName));
            }
            
        }
        else
        {
            Label1.Text = "You did not specify any files to upload or " +
                "the file(s) could not be found.";
        }

    }        
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>HttpFileCollection Example</title>
</head>
<body>
    <form id="form1" 
          runat="server">
    <div>
        <asp:FileUpload ID="FileUpload1" 
                        runat="server" />
        <br />
        <asp:FileUpload ID="FileUpload2" 
                        runat="server" />
        <br />
        <asp:Button ID="Button1" 
                    runat="server" 
                    OnClick="Button1_Click" 
                    Text="Upload" />
        <br />
        <asp:Label ID="Label1" 
                   runat="server"/>
        <br />
        <asp:BulletedList ID="BulletedList1" 
                          runat="server">
        </asp:BulletedList>
        </div>
    </form>
</body>
</html>

<%@ Page Language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

    Protected Sub Button1_Click(ByVal sender As Object, ByVal e As System.EventArgs)

        ' Clear the BulletedList.
        BulletedList1.Items.Clear()
        
        ' Check to see if at least one file was specified.
        If (FileUpload1.HasFile Or FileUpload2.HasFile) Then
            
            Label1.Text = "The file collection consists of:"
            
            ' Get the HttpFileCollection.
            Dim hfc As HttpFileCollection = Request.Files
            For Each h As String In hfc.AllKeys
                
                ' Add an item to the BulletedList if a file
                ' was specified for the corresponding control.
                If (hfc(h).ContentLength > 0) Then
                    BulletedList1.Items.Add(Server.HtmlEncode(hfc(h).FileName))
                End If
            Next
        Else
            
            Label1.Text = "You did not specify any files to upload or " & _
                "the file(s) could not be found."
            
        End If
    End Sub
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
    <title>HttpFileCollection Example</title>
</head>
<body>
    <form id="form1" 
          runat="server">
    <div>
        <asp:FileUpload ID="FileUpload1" 
                        runat="server" />
        <br />
        <asp:FileUpload ID="FileUpload2" 
                        runat="server" />
        <br />
        <asp:Button ID="Button1" 
                    runat="server" 
                    OnClick="Button1_Click" 
                    Text="Upload" />
        <br />
        <asp:Label ID="Label1" 
                   runat="server"/>
        <br />
        <asp:BulletedList ID="BulletedList1" 
                          runat="server">
        </asp:BulletedList>
        </div>
    </form>
</body>
</html>

Açıklamalar

İstemciler dosyaları kodlar ve http üst bilgisi içeren Content-Type çok parçalı MIME biçimini kullanarak içerik gövdesinde iletir multipart/form-data. ASP.NET, kodlanmış dosyaları içerik gövdesinden tek tek üyelerine HttpFileCollectionayıklar. Sınıfının yöntemleri ve özellikleri HttpPostedFile , her dosyanın içeriğine ve özelliklerine erişim sağlar.

Özellikler

Name	Description
AllKeys	Dosya koleksiyonundaki tüm üyelerin anahtarlarını (adlarını) içeren bir dize dizisi alır.
Count	Örnekte bulunan anahtar/değer çiftlerinin NameObjectCollectionBase sayısını alır. (Devralındığı yer: NameObjectCollectionBase)
IsReadOnly	Örneğin salt okunur olup olmadığını NameObjectCollectionBase belirten bir değer alır veya ayarlar. (Devralındığı yer: NameObjectCollectionBase)
Item[Int32]	öğesinden HttpFileCollectionbelirtilen sayısal dizine sahip nesneyi alır.
Item[String]	Belirtilen ada sahip nesneyi dosya koleksiyonundan alır.
Keys	Örnekteki tüm anahtarları NameObjectCollectionBase içeren bir NameObjectCollectionBase.KeysCollection örneği alır. (Devralındığı yer: NameObjectCollectionBase)

Yöntemler

Name	Description
BaseAdd(String, Object)	Örneğe belirtilen anahtar ve değere NameObjectCollectionBase sahip bir girdi ekler. (Devralındığı yer: NameObjectCollectionBase)
BaseClear()	Örnekteki NameObjectCollectionBase tüm girişleri kaldırır. (Devralındığı yer: NameObjectCollectionBase)
BaseGet(Int32)	Örneğin belirtilen dizinindeki girdinin NameObjectCollectionBase değerini alır. (Devralındığı yer: NameObjectCollectionBase)
BaseGet(String)	Örnekten belirtilen anahtara sahip ilk girdinin NameObjectCollectionBase değerini alır. (Devralındığı yer: NameObjectCollectionBase)
BaseGetAllKeys()	Örnekteki tüm anahtarları String içeren bir NameObjectCollectionBase dizi döndürür. (Devralındığı yer: NameObjectCollectionBase)
BaseGetAllValues()	Örnekteki tüm değerleri Object içeren bir NameObjectCollectionBase dizi döndürür. (Devralındığı yer: NameObjectCollectionBase)
BaseGetAllValues(Type)	Örnekteki tüm değerleri NameObjectCollectionBase içeren belirtilen türde bir dizi döndürür. (Devralındığı yer: NameObjectCollectionBase)
BaseGetKey(Int32)	Örneğin belirtilen dizininde girdinin NameObjectCollectionBase anahtarını alır. (Devralındığı yer: NameObjectCollectionBase)
BaseHasKeys()	Örneğin anahtarları olmayan NameObjectCollectionBasegirdiler içerip içermediğini `null` belirten bir değer alır. (Devralındığı yer: NameObjectCollectionBase)
BaseRemove(String)	Belirtilen anahtara sahip girişleri örnekten NameObjectCollectionBase kaldırır. (Devralındığı yer: NameObjectCollectionBase)
BaseRemoveAt(Int32)	Örneğin belirtilen dizinindeki girdiyi NameObjectCollectionBase kaldırır. (Devralındığı yer: NameObjectCollectionBase)
BaseSet(Int32, Object)	Girdinin değerini örneğin belirtilen dizininde NameObjectCollectionBase ayarlar. (Devralındığı yer: NameObjectCollectionBase)
BaseSet(String, Object)	Örnekte belirtilen anahtarla NameObjectCollectionBase ilk girdinin değerini ayarlar; bulunursa, aksi takdirde örneğe belirtilen anahtar ve değere NameObjectCollectionBase sahip bir girdi ekler. (Devralındığı yer: NameObjectCollectionBase)
CopyTo(Array, Int32)	Dosya koleksiyonunun üyelerini dizinin belirtilen dizinindeki bir Array başlanmaya kopyalar.
Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
Get(Int32)	Dosya koleksiyonundan HttpPostedFile belirtilen sayısal dizine sahip nesneyi döndürür.
Get(String)	Dosya koleksiyonundan HttpPostedFile belirtilen ada sahip nesneyi döndürür.
GetEnumerator()	aracılığıyla NameObjectCollectionBaseyineleyen bir numaralandırıcı döndürür. (Devralındığı yer: NameObjectCollectionBase)
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetKey(Int32)	Belirtilen sayısal dizine HttpFileCollection sahip üyenin adını döndürür.
GetMultiple(String)	Belirtilen adla eşleşen tüm dosyaları döndürür.
GetObjectData(SerializationInfo, StreamingContext)	Geçersiz. Arabirimini ISerializable uygular ve örneği serileştirmek NameObjectCollectionBase için gereken verileri döndürür. (Devralındığı yer: NameObjectCollectionBase)
GetType()	Geçerli örneğin Type alır. (Devralındığı yer: Object)
MemberwiseClone()	Geçerli Objectbasit bir kopyasını oluşturur. (Devralındığı yer: Object)
OnDeserialization(Object)	Arabirimini ISerializable uygular ve seri durumdan çıkarma işlemi tamamlandığında seri durumdan çıkarma olayını başlatır. (Devralındığı yer: NameObjectCollectionBase)
ToString()	Geçerli nesneyi temsil eden bir dize döndürür. (Devralındığı yer: Object)

Belirtik Arabirim Kullanımları

Name	Description
ICollection.CopyTo(Array, Int32)	Hedef dizinin belirtilen dizininden başlayarak tamamını NameObjectCollectionBase uyumlu bir tek boyutluya Arraykopyalar. (Devralındığı yer: NameObjectCollectionBase)
ICollection.IsSynchronized	Nesneye erişimin NameObjectCollectionBase eşitlenip eşitlenmediğini belirten bir değer alır (iş parçacığı güvenli). (Devralındığı yer: NameObjectCollectionBase)
ICollection.SyncRoot	Nesneye erişimi NameObjectCollectionBase eşitlemek için kullanılabilecek bir nesne alır. (Devralındığı yer: NameObjectCollectionBase)

Uzantı Metotları

Name	Description
AsParallel(IEnumerable)	Sorgunun paralelleştirilmesini etkinleştirir.
AsQueryable(IEnumerable)	bir IEnumerable öğesine IQueryabledönüştürür.
Cast<TResult>(IEnumerable)	öğesinin IEnumerable öğelerini belirtilen türe yazar.
OfType<TResult>(IEnumerable)	Belirtilen türe göre bir IEnumerable öğesinin öğelerini filtreler.

Şunlara uygulanır

Ayrıca bkz.

Geri Bildirim

Bu sayfayı yararlı buldunuz mu?