Image.FromFile Método

Definición

Espacio de nombres:

System.Drawing

Ensamblado:

System.Drawing.Common.dll

Paquete:

System.Drawing.Common v8.0.0

Crea un Image a partir del archivo especificado.

Sobrecargas

FromFile(String)	Crea un Image a partir del archivo especificado.
FromFile(String, Boolean)	Crea Image a partir del archivo especificado utilizando información de administración del color incrustada en dicho archivo.

FromFile(String)

Source:

Image.cs

Crea un Image a partir del archivo 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

Cadena que contiene el nombre del archivo a partir del que se va a crear Image.

Devoluciones

Image

Image que crea este método.

Excepciones

OutOfMemoryException

El archivo no tiene un formato de imagen válido.

o bien

GDI+ no admite el formato de píxel del archivo.

FileNotFoundException

El archivo especificado no existe.

ArgumentException

filename es un objeto Uri.

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar los FromFileGetPropertyItem métodos y SetPropertyItem . Este ejemplo está diseñado para usarse con Windows Forms. Para ejecutar este ejemplo, péguelo en un formulario y controle el evento del Paint formulario mediante una llamada al DemonstratePropertyItem método , pasando 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

Comentarios

GDI+ administrado tiene codificadores y descodificadores integrados que admiten los siguientes tipos de archivo:

• BMP

• GIF

• JPEG

• PNG

• TIFF

El archivo permanece bloqueado hasta Image que se elimina .

Si el archivo no tiene un formato de imagen válido o si GDI+ no admite el formato de píxel del archivo, este método produce una OutOfMemoryException excepción.

Nota

La Image clase no admite la transparencia alfa en mapas de bits. Para habilitar la transparencia alfa, use imágenes PNG con 32 bits por píxel.

Consulte también

• Tipos de mapas de bits

FromFile(String, Boolean)

Source:

Image.cs

Crea Image a partir del archivo especificado utilizando información de administración del color incrustada en dicho archivo.

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

Cadena que contiene el nombre del archivo a partir del que se va a crear Image.

useEmbeddedColorManagement

Boolean

Se establece en true para utilizar la información de administración del color incrustada en el archivo de imagen; en caso contrario, false.

Devoluciones

Image

Image que crea este método.

Excepciones

OutOfMemoryException

El archivo no tiene un formato de imagen válido.

o bien

GDI+ no admite el formato de píxel del archivo.

FileNotFoundException

El archivo especificado no existe.

ArgumentException

filename es un objeto Uri.

Ejemplos

En el ejemplo de código siguiente se muestra cómo obtener un nuevo mapa de bits mediante el FromFile método . También muestra un .TextureBrush

Este ejemplo está diseñado para usarse con Windows Forms. Create un formulario que contiene un botón denominado Button2. Pegue el código en el formulario y asocie el Button2_Click método al evento del Click botón.

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

Comentarios

GDI+ administrado tiene codificadores y descodificadores integrados que admiten los siguientes tipos de archivo:

• BMP

• GIF

• JPEG

• PNG

• TIFF

Si el archivo no tiene un formato de imagen válido o si GDI+ no admite el formato de píxel del archivo, este método produce una OutOfMemoryException excepción.

El archivo permanece bloqueado hasta Image que se elimina .

El useEmbeddedColorManagement parámetro especifica si el nuevo Image aplica la corrección de color según la información de administración de colores incrustada en el archivo de imagen. La información insertada puede incluir perfiles de International Color Consortium (ICC), valores gamma e información de cromatística.

Nota

La Image clase no admite la transparencia alfa en mapas de bits. Para habilitar la transparencia alfa, use imágenes PNG con 32 bits por píxel.

Consulte también

• Tipos de mapas de bits