Interaction.GetObject(String, String) 메서드

[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static object? GetObject (string? PathName = default, string? Class = default);

public static object GetObject (string PathName = default, string Class = default);

[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member GetObject : string * string -> obj

static member GetObject : string * string -> obj

Public Function GetObject (Optional PathName As String = Nothing, Optional Class As String = Nothing) As Object

매개 변수

반환

COM 구성 요소에 의해 제공된 개체에 대한 참조입니다.

특성

SupportedOSPlatformAttribute

예외

예제

다음 예제에서는 함수를 GetObject 사용하여 특정 Microsoft Excel 워크시트(excelObj)에 대한 참조를 가져옵니다. 워크시트의 Application 속성을 사용하여 Excel을 표시하고, 닫고, 다른 작업을 수행합니다. 프로시저는 두 개의 API 호출을 detectExcel 사용하여 Excel을 찾고 실행 중인 경우 실행 중인 개체 테이블에 입력합니다. 에 대한 GetObject 첫 번째 호출은 Excel이 아직 실행되고 있지 않으면 오류가 발생하며, 이 예제에서는 플래그가 excelWasNotRunning 로 True설정됩니다. 에 대한 GetObject 두 번째 호출은 열 파일을 지정합니다. Excel이 아직 실행되고 있지 않으면 두 번째 호출이 시작되고 지정된 파일 test.xls로 표시되는 워크시트에 대한 참조를 반환합니다. 파일은 지정된 위치에 있어야 합니다. 그렇지 않으면 Visual Basic에서 을 FileNotFoundExceptionthrow합니다. 다음으로, 예제 코드는 Excel과 지정된 워크시트가 포함된 창을 모두 표시합니다.

이 예제에서는 개체가 Option Strict Off 형식 Object의 변수에 할당되는 지연 바인딩을 사용하기 때문에 가 필요합니다. Visual Studio의 프로젝트 메뉴에 있는 참조 추가 대화 상자의 COM 탭에서 Excel 형식 라이브러리에 대한 참조를 추가하는 경우 특정 개체 형식의 개체를 지정 Option Strict On 하고 선언할 수 있습니다.

' Add Option Strict Off to the top of your program.
Option Strict Off

' Test to see if a copy of Excel is already running.
Private Sub testExcelRunning()
    On Error Resume Next
    ' GetObject called without the first argument returns a
    ' reference to an instance of the application. If the
    ' application is not already running, an error occurs.
    Dim excelObj As Object = GetObject(, "Excel.Application")
    If Err.Number = 0 Then
        MsgBox("Excel is running")
    Else
        MsgBox("Excel is not running")
    End If
    Err.Clear()
    excelObj = Nothing
End Sub

Private Sub getExcel()
    Dim fileName As String = "c:\vb\test.xls"

    If Not My.Computer.FileSystem.FileExists(fileName) Then
        MsgBox(fileName & " does not exist")
        Exit Sub
    End If

    ' Set the object variable to refer to the file you want to use.
    Dim excelObj As Object = GetObject(fileName)
    ' Show Excel through its Application property. 
    excelObj.Application.Visible = True
    ' Show the window containing the file.
    Dim winCount As Integer = excelObj.Parent.Windows.Count()
    excelObj.Parent.Windows(winCount).Visible = True

    ' Insert additional code to manipulate the test.xls file here.
    ' ...

    excelObj = Nothing
End Sub

함수를 getExcel 호출하면 Excel이 이미 실행 중인지 확인하기 위해 검사 만들어집니다. 그렇지 않으면 instance 만들어집니다.

설명

함수를 GetObject 사용하여 파일에서 COM 구성 요소의 instance 로드합니다. 다음은 이에 대한 예입니다.

Dim CADObject As Object  
CADObject = GetObject("C:\CAD\schema.cad")  

이 코드를 실행 하면 지정 된 관련 애플리케이션 PathName 시작 되 고 지정된 된 파일에서 개체 활성화 됩니다.

기본 사례

가 길이가 0인 문자열("") GetObject 이면 PathName 지정된 클래스 형식의 instance 새 개체를 반환합니다. 인수를 PathName 생략 GetObject 하면 에 지정된 클래스 형식의 현재 활성 개체를 Class반환합니다. 지정된 형식의 개체가 없으면 오류가 발생합니다.

하위 개체에 액세스

일부 애플리케이션 파일과 연결 된 하위 활성화를 허용 합니다. 이렇게 하려면 파일 이름 끝에 느낌표(!)를 추가하고 활성화하려는 파일의 부분을 식별하는 문자열을 사용합니다. 이 문자열을 만드는 방법에 대 한 자세한 내용은 개체를 만든 애플리케이션에 대 한 설명서를 참조 하세요.

예를 들어 드로잉 애플리케이션에서 파일에 저장 된 그리기에 여러 계층이 있는 될 수 있습니다. 다음 코드를 사용하여 라는 schema.cad드로잉 내에서 레이어를 활성화할 수 있습니다.

layerObject = GetObject("C:\CAD\schema.cad!Layer3")  

클래스 지정

개체를 지정 하지 않는 경우 Class, 자동화를 시작 및 개체를 활성화 하려면 애플리케이션 제공한 파일 이름을 기반으로 결정 합니다. 그러나 일부 파일은 둘 이상의 개체 클래스를 지원할 수 있습니다. 예를 들어 드로잉은 개체, 개체 및 Toolbar 개체의 세 가지 유형의 개체 Application 를 Drawing 지원할 수 있으며, 모두 동일한 파일의 일부입니다. 활성화할 파일에서 개체를 지정하려면 선택적 Class 인수를 사용합니다. 다음은 이에 대한 예입니다.

Dim drawObj As Object  
drawObj = GetObject("C:\Drawings\sample.drw", "Figment.Drawing")  

위의 예에서 Figment 그리기 애플리케이션의 이름 및 Drawing 지 원하는 개체 형식 중 하나입니다.

개체 사용

개체가 활성화되면 선언한 개체 변수를 사용하여 코드에서 개체를 참조합니다. 앞의 예제에서는 개체 변수 drawObj를 사용하여 새 개체의 속성 및 메서드에 액세스합니다. 다음은 이에 대한 예입니다.

drawObj.Line(9, 90)  
drawObj.InsertText(9, 100, "Hello, world.")  
drawObj.SaveAs("C:\Drawings\sample.drw")  

적용 대상

추가 정보

• CreateObject(String, String)
• Exception
• FileNotFoundException
• Declare 문
• Option Strict 문