Image.FromFile Metode

Definisi

Ruang nama:

System.Drawing

Rakitan:

System.Drawing.Common.dll

Paket:

System.Drawing.Common v8.0.0

Image Membuat dari file yang ditentukan.

Overload

FromFile(String)	Image Membuat dari file yang ditentukan.
FromFile(String, Boolean)	Image Membuat dari file yang ditentukan menggunakan informasi manajemen warna yang disematkan dalam file tersebut.

FromFile(String)

Sumber:

Image.cs

Image Membuat dari file yang ditentukan.

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

Parameter

filename

String

String yang berisi nama file untuk membuat Image.

Mengembalikan

Image

Metode Image ini dibuat.

Pengecualian

OutOfMemoryException

File tidak memiliki format gambar yang valid.

-atau-

GDI+ tidak mendukung format piksel file.

FileNotFoundException

File yang ditentukan tidak ada.

ArgumentException

filename adalah Uri.

Contoh

Contoh kode berikut menunjukkan cara menggunakan FromFileGetPropertyItem metode dan SetPropertyItem . Contoh ini dirancang untuk digunakan dengan Formulir Windows. Untuk menjalankan contoh ini, tempelkan ke dalam formulir, dan tangani peristiwa formulir Paint dengan memanggil DemonstratePropertyItem metode , meneruskannya e sebagai PaintEventArgs.

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

Keterangan

GDI+ terkelola memiliki encoder dan dekoder bawaan yang mendukung jenis file berikut:

• BMP

• GIF

• JPEG

• PNG

• TIFF

File tetap terkunci sampai Image dibuang.

Jika file tidak memiliki format gambar yang valid atau jika GDI+ tidak mendukung format piksel file, metode ini memberikan OutOfMemoryException pengecualian.

Catatan

Kelas Image tidak mendukung transparansi alfa dalam bitmap. Untuk mengaktifkan transparansi alfa, gunakan gambar PNG dengan 32 bit per piksel.

Lihat juga

• Jenis Bitmap

FromFile(String, Boolean)

Sumber:

Image.cs

Image Membuat dari file yang ditentukan menggunakan informasi manajemen warna yang disematkan dalam file tersebut.

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

Parameter

filename

String

String yang berisi nama file untuk membuat Image.

useEmbeddedColorManagement

Boolean

Atur ke true untuk menggunakan informasi manajemen warna yang disematkan dalam file gambar; jika tidak, false.

Mengembalikan

Image

Metode Image ini dibuat.

Pengecualian

OutOfMemoryException

File tidak memiliki format gambar yang valid.

-atau-

GDI+ tidak mendukung format piksel file.

FileNotFoundException

File yang ditentukan tidak ada.

ArgumentException

filename adalah Uri.

Contoh

Contoh kode berikut menunjukkan cara mendapatkan bitmap baru menggunakan FromFile metode . Ini juga menunjukkan TextureBrush.

Contoh ini dirancang untuk digunakan dengan Formulir Windows. Create formulir yang berisi tombol bernama Button2. Tempelkan kode ke dalam formulir dan kaitkan Button2_Click metode dengan peristiwa tombol Click .

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

Keterangan

GDI+ terkelola memiliki encoder dan dekoder bawaan yang mendukung jenis file berikut:

• BMP

• GIF

• JPEG

• PNG

• TIFF

Jika file tidak memiliki format gambar yang valid atau jika GDI+ tidak mendukung format piksel file, metode ini memberikan OutOfMemoryException pengecualian.

File tetap terkunci sampai Image dibuang.

Parameter useEmbeddedColorManagement menentukan apakah yang baru Image menerapkan koreksi warna sesuai dengan informasi manajemen warna yang disematkan dalam file gambar. Informasi yang disematkan dapat mencakup profil International Color Consortium (ICC), nilai gamma, dan informasi kromatikitas.

Catatan

Kelas Image tidak mendukung transparansi alfa dalam bitmap. Untuk mengaktifkan transparansi alfa, gunakan gambar PNG dengan 32 bit per piksel.

Lihat juga

• Jenis Bitmap