Image.FromFile Método

Definição

Namespace:

System.Drawing

Assembly:

System.Drawing.Common.dll

Pacote:

System.Drawing.Common v8.0.0

Cria um Image com base no arquivo especificado.

Sobrecargas

FromFile(String)	Cria um Image com base no arquivo especificado.
FromFile(String, Boolean)	Cria um Image do arquivo especificado usando informações de gerenciamento de cores incorporadas nesse arquivo.

FromFile(String)

Origem:

Image.cs

Cria um Image com base no arquivo especificado.

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

Parâmetros

filename

String

Uma cadeia de caracteres que contém o nome do arquivo com base no qual o Image será criado.

Retornos

Image

O Image criado por esse método.

Exceções

OutOfMemoryException

O arquivo não tem um formato de imagem válido.

- ou -

O GDI+ não dá suporte ao formato de pixel do arquivo.

FileNotFoundException

O arquivo especificado não existe.

ArgumentException

filename é um Uri.

Exemplos

O exemplo de código a seguir demonstra como usar os FromFileGetPropertyItem métodos e SetPropertyItem . Este exemplo foi projetado para ser usado com Windows Forms. Para executar este exemplo, cole-o em um formulário e manipule o evento do Paint formulário chamando o DemonstratePropertyItem método , passando e como 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

Comentários

O GDI+ gerenciado tem codificadores e decodificadores internos que dão suporte aos seguintes tipos de arquivo:

• BMP

• GIF

• JPEG

• PNG

• TIFF

O arquivo permanece bloqueado até que o Image seja descartado.

Se o arquivo não tiver um formato de imagem válido ou se GDI+ não der suporte ao formato de pixel do arquivo, esse método gerará uma exceção OutOfMemoryException .

Observação

A Image classe não dá suporte à transparência alfa em bitmaps. Para habilitar a transparência alfa, use imagens PNG com 32 bits por pixel.

Confira também

• Tipos de bitmaps

FromFile(String, Boolean)

Origem:

Image.cs

Cria um Image do arquivo especificado usando informações de gerenciamento de cores incorporadas nesse arquivo.

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

Parâmetros

filename

String

Uma cadeia de caracteres que contém o nome do arquivo com base no qual o Image será criado.

useEmbeddedColorManagement

Boolean

Definido como true para usar informações de gerenciamento de cores incorporadas no arquivo de imagem; caso contrário, false.

Retornos

Image

O Image criado por esse método.

Exceções

OutOfMemoryException

O arquivo não tem um formato de imagem válido.

- ou -

O GDI+ não dá suporte ao formato de pixel do arquivo.

FileNotFoundException

O arquivo especificado não existe.

ArgumentException

filename é um Uri.

Exemplos

O exemplo de código a seguir demonstra como obter um novo bitmap usando o FromFile método . Ele também demonstra um TextureBrush.

Este exemplo foi projetado para ser usado com Windows Forms. Crie um formulário contendo um botão chamado Button2. Cole o código no formulário e associe o Button2_Click método ao evento do Click botão.

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

Comentários

O GDI+ gerenciado tem codificadores e decodificadores internos que dão suporte aos seguintes tipos de arquivo:

• BMP

• GIF

• JPEG

• PNG

• TIFF

Se o arquivo não tiver um formato de imagem válido ou se GDI+ não der suporte ao formato de pixel do arquivo, esse método gerará uma exceção OutOfMemoryException .

O arquivo permanece bloqueado até que o Image seja descartado.

O useEmbeddedColorManagement parâmetro especifica se o novo Image aplica correção de cor de acordo com as informações de gerenciamento de cores inseridas no arquivo de imagem. As informações inseridas podem incluir perfis do ICC (International Color Consortium), valores gama e informações de cromática.

Observação

A Image classe não dá suporte à transparência alfa em bitmaps. Para habilitar a transparência alfa, use imagens PNG com 32 bits por pixel.

Confira também

• Tipos de bitmaps