Image.FromFile Metoda

Definice

Obor názvů:

System.Drawing

Sestavení:

System.Drawing.Common.dll

Balíček:

System.Drawing.Common v11.0.0-rc.1.26425.128

Vytvoří ze Image zadaného souboru.

Přetížení

Name	Description
FromFile(String)	Vytvoří ze Image zadaného souboru.
FromFile(String, Boolean)	Vytvoří ze zadaného souboru vložené Image informace o správě barev v tomto souboru.

FromFile(String)

Zdroj:

Image.cs

Vytvoří ze Image zadaného souboru.

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

Parametry

filename

String

Řetězec, který obsahuje název souboru, ze kterého chcete vytvořit Image.

Návraty

Image

Tato Image metoda vytvoří.

Výjimky

OutOfMemoryException

Soubor nemá platný formát obrázku.

nebo

GDI+ nepodporuje formát pixelů souboru.

FileNotFoundException

Zadaný soubor neexistuje.

ArgumentException

filenameje .Uri

Příklady

Následující příklad kódu ukazuje, jak používat FromFileGetPropertyItem a SetPropertyItem metody. Tento příklad je navržený tak, aby se používal s model Windows Forms. Pokud chcete tento příklad spustit, vložte ho do formuláře a zpracujte událost formuláře Paint voláním DemonstratePropertyItem metody a předáním e jako 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

Poznámky

Managed GDI+ má integrované kodéry a dekodéry, které podporují následující typy souborů:

• BMP

• GIF

• JPEG

• formát PNG

• formát TIFF

Soubor zůstane uzamčený, dokud nebude Image odstraněn.

Pokud soubor nemá platný formát obrázku nebo pokud GDI+ nepodporuje formát pixelů souboru, vyvolá tato metoda OutOfMemoryException výjimku.

Note

Třída Image nepodporuje alfa průhlednost v bitmapách. Pokud chcete povolit alfa průhlednost, použijte obrázky PNG s 32 bity na pixel.

Viz také

• typy rastrových obrázků

FromFile(String, Boolean)

Zdroj:

Image.cs

Vytvoří ze zadaného souboru vložené Image informace o správě barev v tomto souboru.

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

Parametry

filename

String

Řetězec, který obsahuje název souboru, ze kterého chcete vytvořit Image.

useEmbeddedColorManagement

Boolean

Nastavení pro true použití informací o správě barev vložených do souboru obrázku; v opačném případě false.

Návraty

Image

Tato Image metoda vytvoří.

Výjimky

OutOfMemoryException

Soubor nemá platný formát obrázku.

nebo

GDI+ nepodporuje formát pixelů souboru.

FileNotFoundException

Zadaný soubor neexistuje.

ArgumentException

filenameje .Uri

Příklady

Následující příklad kódu ukazuje, jak získat nový bitmap pomocí FromFile metody. Ukazuje také TextureBrush.

Tento příklad je navržený tak, aby se používal s model Windows Forms. Vytvořte formulář obsahující tlačítko s názvem Button2. Vložte kód do formuláře a přidružte Button2_Click metodu k události tlačítka 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

Poznámky

Managed GDI+ má integrované kodéry a dekodéry, které podporují následující typy souborů:

• BMP

• GIF

• JPEG

• formát PNG

• formát TIFF

Pokud soubor nemá platný formát obrázku nebo pokud GDI+ nepodporuje formát pixelů souboru, vyvolá tato metoda OutOfMemoryException výjimku.

Soubor zůstane uzamčený, dokud nebude Image odstraněn.

Parametr useEmbeddedColorManagement určuje, zda nový Image použije opravu barev podle informací o správě barev, které jsou vloženy do souboru obrázku. Vložené informace můžou zahrnovat profily mezinárodního konsorcia Color Consortium (ICC), hodnoty gama a informace o chromatičnosti.

Note

Třída Image nepodporuje alfa průhlednost v bitmapách. Pokud chcete povolit alfa průhlednost, použijte obrázky PNG s 32 bity na pixel.

Viz také

• typy rastrových obrázků