HttpFileCollection Sınıf

Başvuru

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 denetimde BulletedList 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 Content-Type üst bilgisi ile çok parçalı MIME biçimini kullanarak içerik gövdesinde multipart/form-datailetir. 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

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]	Dosya koleksiyonundan belirtilen ada sahip nesneyi alır.
Keys	Örnekteki tüm anahtarları NameObjectCollectionBase içeren bir NameObjectCollectionBase.KeysCollection örneği alır. (Devralındığı yer: NameObjectCollectionBase)

Yöntemler

BaseAdd(String, Object)	Örneğe belirtilen anahtar ve değere NameObjectCollectionBase sahip bir girdi ekler. (Devralındığı yer: NameObjectCollectionBase)
BaseClear()	Örnekteki NameObjectCollectionBase tüm girdileri 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ı NameObjectCollectionBase içeren bir String dizi döndürür. (Devralındığı yer: NameObjectCollectionBase)
BaseGetAllValues()	Örnekteki tüm değerleri NameObjectCollectionBase içeren bir Object 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 dizinindeki girdinin NameObjectCollectionBase anahtarını alır. (Devralındığı yer: NameObjectCollectionBase)
BaseHasKeys()	Örneğin anahtarları olmayan `null`girdiler içerip içermediğini NameObjectCollectionBase 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 anahtara NameObjectCollectionBase sahip ilk girdinin değerini ayarlar( bulunursa), aksi takdirde örneğe NameObjectCollectionBase belirtilen anahtar ve değere 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)	Arabirimini ISerializable uygular ve örneği seri hale NameObjectCollectionBase getirmek için gereken verileri döndürür. (Devralındığı yer: NameObjectCollectionBase)
GetType()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
MemberwiseClone()	Geçerli Objectöğesinin sığ 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 dizeyi döndürür. (Devralındığı yer: Object)

Belirtik Arabirim Kullanımları

ICollection.CopyTo(Array, Int32)	Hedef dizinin belirtilen dizininden başlayarak tamamını NameObjectCollectionBase uyumlu bir tek boyutlu Arrayöğesine kopyalar. (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ı

Cast<TResult>(IEnumerable)	öğesinin IEnumerable öğelerini belirtilen türe atar.
OfType<TResult>(IEnumerable)	Bir öğesinin IEnumerable öğelerini belirtilen türe göre filtreler.
AsParallel(IEnumerable)	Sorgunun paralelleştirilmesini sağlar.
AsQueryable(IEnumerable)	bir IEnumerable öğesini öğesine IQueryabledönüştürür.

Şunlara uygulanır