Image.FromFile Yöntem

Tanım

Ad Alanı:

System.Drawing

Bütünleştirilmiş Kod:

System.Drawing.Common.dll

Paket:

System.Drawing.Common v9.0.0-rc.2.24474.1

Belirtilen dosyadan bir Image oluşturur.

Aşırı Yüklemeler

FromFile(String)	Belirtilen dosyadan bir Image oluşturur.
FromFile(String, Boolean)	Bu dosyadaki katıştırılmış renk yönetimi bilgilerini kullanarak belirtilen dosyadan bir Image oluşturur.

FromFile(String)

Kaynak:

Image.cs

Belirtilen dosyadan bir Image oluşturur.

public:
 static System::Drawing::Image ^ FromFile(System::String ^ filename);

public static System.Drawing.Image FromFile (string filename);

static member FromFile : string -> System.Drawing.Image

Public Shared Function FromFile (filename As String) As Image

Parametreler

filename

String

Imageoluşturulacak dosyanın adını içeren dize.

Döndürülenler

Image

Bu yöntemin oluşturduğu Image.

Özel durumlar

OutOfMemoryException

Dosyanın geçerli bir görüntü biçimi yok.

-veya-

GDI+, dosyanın piksel biçimini desteklemez.

FileNotFoundException

Belirtilen dosya yok.

ArgumentException

filename bir Uri.

Örnekler

Aşağıdaki kod örneği, FromFileGetPropertyItem ve SetPropertyItem yöntemlerinin nasıl kullanılacağını gösterir. Bu örnek, Windows Forms ile kullanılacak şekilde tasarlanmıştır. Bu örneği çalıştırmak için bir forma yapıştırın ve ePaintEventArgsolarak geçirerek DemonstratePropertyItem yöntemini çağırarak formun Paint olayını işleyebilir.

private:
   void DemonstratePropertyItem( PaintEventArgs^ e )
   {
      // Create two images.
      Image^ image1 = Image::FromFile( "c:\\FakePhoto1.jpg" );
      Image^ image2 = Image::FromFile( "c:\\FakePhoto2.jpg" );

      // Get a PropertyItem from image1.
      PropertyItem^ propItem = image1->GetPropertyItem( 20624 );

      // Change the ID of the PropertyItem.
      propItem->Id = 20625;

      // Set the PropertyItem for image2.
      image2->SetPropertyItem( propItem );

      // Draw the image.
      e->Graphics->DrawImage( image2, 20.0F, 20.0F );
   }

private void DemonstratePropertyItem(PaintEventArgs e)
{

    // Create two images.
    Image image1 = Image.FromFile("c:\\FakePhoto1.jpg");
    Image image2 = Image.FromFile("c:\\FakePhoto2.jpg");

    // Get a PropertyItem from image1.
    PropertyItem propItem = image1.GetPropertyItem(20624);

    // Change the ID of the PropertyItem.
    propItem.Id = 20625;

    // Set the PropertyItem for image2.
    image2.SetPropertyItem(propItem);

    // Draw the image.
    e.Graphics.DrawImage(image2, 20.0F, 20.0F);
}

Private Sub DemonstratePropertyItem(ByVal e As PaintEventArgs)

    ' Create two images.
    Dim image1 As Image = Image.FromFile("c:\FakePhoto1.jpg")
    Dim image2 As Image = Image.FromFile("c:\FakePhoto2.jpg")

    ' Get a PropertyItem from image1.
    Dim propItem As PropertyItem = image1.GetPropertyItem(20624)

    ' Change the ID of the PropertyItem.
    propItem.Id = 20625

    ' Set the PropertyItem for image2.
    image2.SetPropertyItem(propItem)

    ' Draw the image.
    e.Graphics.DrawImage(image2, 20.0F, 20.0F)
End Sub

Açıklamalar

Yönetilen GDI+, aşağıdaki dosya türlerini destekleyen yerleşik kodlayıcılara ve kod çözücülere sahiptir:

• BMP

• GIF

• JPEG

• PNG

• TIFF

Image atılana kadar dosya kilitli kalır.

Dosyanın geçerli bir görüntü biçimi yoksa veya GDI+ dosyanın piksel biçimini desteklemiyorsa, bu yöntem bir OutOfMemoryException özel durumu oluşturur.

Not

Image sınıfı bit eşlemlerde alfa saydamlığını desteklemez. Alfa saydamlığı etkinleştirmek için piksel başına 32 bit ile PNG görüntüleri kullanın.

Ayrıca bkz.

• Bit Eşlem Türleri

FromFile(String, Boolean)

Kaynak:

Image.cs

Bu dosyadaki katıştırılmış renk yönetimi bilgilerini kullanarak belirtilen dosyadan bir Image oluşturur.

public:
 static System::Drawing::Image ^ FromFile(System::String ^ filename, bool useEmbeddedColorManagement);

public static System.Drawing.Image FromFile (string filename, bool useEmbeddedColorManagement);

static member FromFile : string * bool -> System.Drawing.Image

Public Shared Function FromFile (filename As String, useEmbeddedColorManagement As Boolean) As Image

Parametreler

filename

String

Imageoluşturulacak dosyanın adını içeren dize.

useEmbeddedColorManagement

Boolean

Görüntü dosyasına katıştırılmış renk yönetimi bilgilerini kullanmak için true olarak ayarlayın; aksi takdirde false.

Döndürülenler

Image

Bu yöntemin oluşturduğu Image.

Özel durumlar

OutOfMemoryException

Dosyanın geçerli bir görüntü biçimi yok.

-veya-

GDI+, dosyanın piksel biçimini desteklemez.

FileNotFoundException

Belirtilen dosya yok.

ArgumentException

filename bir Uri.

Örnekler

Aşağıdaki kod örneği, FromFile yöntemini kullanarak yeni bir bit eşlem elde etme işlemini gösterir. Ayrıca bir TextureBrushgösterir.

Bu örnek, Windows Forms ile kullanılacak şekilde tasarlanmıştır. Button2adlı düğmeyi içeren bir form oluşturun. Kodu forma yapıştırın ve Button2_Click yöntemini düğmenin Click olayıyla ilişkilendirin.

private:
   void Button2_Click( System::Object^ /*sender*/, System::EventArgs^ /*e*/ )
   {
      try
      {
         Bitmap^ image1 = dynamic_cast<Bitmap^>(Image::FromFile( "C:\\Documents and Settings\\"
         "All Users\\Documents\\My Music\\music.bmp", true ));
         TextureBrush^ texture = gcnew TextureBrush( image1 );
         texture->WrapMode = System::Drawing::Drawing2D::WrapMode::Tile;
         Graphics^ formGraphics = this->CreateGraphics();
         formGraphics->FillEllipse( texture, RectangleF(90.0F,110.0F,100,100) );
         delete formGraphics;
      }
      catch ( System::IO::FileNotFoundException^ ) 
      {
         MessageBox::Show( "There was an error opening the bitmap."
         "Please check the path." );
      }
   }

private void Button2_Click(System.Object sender, System.EventArgs e)
{
    try
    {
        Bitmap image1 = (Bitmap) Image.FromFile(@"C:\Documents and Settings\" +
            @"All Users\Documents\My Music\music.bmp", true);

        TextureBrush texture = new TextureBrush(image1);
        texture.WrapMode = System.Drawing.Drawing2D.WrapMode.Tile;
        Graphics formGraphics = this.CreateGraphics();
        formGraphics.FillEllipse(texture, 
            new RectangleF(90.0F, 110.0F, 100, 100));
        formGraphics.Dispose();
    }
    catch(System.IO.FileNotFoundException)
    {
        MessageBox.Show("There was an error opening the bitmap." +
            "Please check the path.");
    }
}

Private Sub Button2_Click(ByVal sender As System.Object, _
    ByVal e As System.EventArgs) Handles Button2.Click
    Try
        Dim image1 As Bitmap = _
            CType(Image.FromFile("C:\Documents and Settings\" _
            & "All Users\Documents\My Music\music.bmp", True), Bitmap)

        Dim texture As New TextureBrush(image1)
        texture.WrapMode = Drawing2D.WrapMode.Tile
        Dim formGraphics As Graphics = Me.CreateGraphics()
        formGraphics.FillEllipse(texture, _
            New RectangleF(90.0F, 110.0F, 100, 100))
        formGraphics.Dispose()

    Catch ex As System.IO.FileNotFoundException
        MessageBox.Show("There was an error opening the bitmap." _
            & "Please check the path.")
    End Try

End Sub

Açıklamalar

Yönetilen GDI+, aşağıdaki dosya türlerini destekleyen yerleşik kodlayıcılara ve kod çözücülere sahiptir:

• BMP

• GIF

• JPEG

• PNG

• TIFF

Dosyanın geçerli bir görüntü biçimi yoksa veya GDI+ dosyanın piksel biçimini desteklemiyorsa, bu yöntem bir OutOfMemoryException özel durumu oluşturur.

Image atılana kadar dosya kilitli kalır.

useEmbeddedColorManagement parametresi, yeni Image görüntü dosyasına eklenmiş renk yönetimi bilgilerine göre renk düzeltmesi uygulayıp uygulamayacağını belirtir. Katıştırılmış bilgiler Uluslararası Renk Konsorsiyumu (ICC) profillerini, gama değerlerini ve kromasite bilgilerini içerebilir.

Not

Image sınıfı bit eşlemlerde alfa saydamlığını desteklemez. Alfa saydamlığı etkinleştirmek için piksel başına 32 bit ile PNG görüntüleri kullanın.

Ayrıca bkz.

• Bit Eşlem Türleri