Image.FromFile Método

Referencia

Definición

Espacio de nombres:: System.Drawing

Ensamblado:: System.Drawing.Common.dll

Ensamblado:: System.Drawing.dll

Paquete:: System.Drawing.Common v6.0.0

Paquete:: System.Drawing.Common v7.0.0

Paquete:: System.Drawing.Common v8.0.0

Paquete:: System.Drawing.Common v9.0.0-preview.2.24128.3

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

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

Source:: Image.cs

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 FromFile GetPropertyItem 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

Se aplica a

.NET Framework 4.8.1 y otras versiones

Producto	Versiones
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop	3.0, 3.1, 5, 6, 7, 8, 9

FromFile(String, Boolean)

Source:: Image.cs

Source:: Image.cs

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

Se aplica a

.NET Framework 4.8.1 y otras versiones

Producto	Versiones
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop	3.0, 3.1, 5, 6, 7, 8, 9

Compartir a través de

Image.FromFile Método

Definición

Sobrecargas

FromFile(String)

Parámetros

Devoluciones

Excepciones

Ejemplos

Comentarios

Consulte también

Se aplica a

FromFile(String, Boolean)

Parámetros

Devoluciones

Excepciones

Ejemplos

Comentarios

Consulte también

Se aplica a

Recursos adicionales